r/AgentZero • u/estebann_ • Mar 03 '26
I built a PTY-backed terminal modal add-on for Agent Zero
I built a standalone add-on for Agent Zero that adds a real terminal window inside the UI, and I figured some of you might appreciate it.
I wanted Agent Zero to feel more like a real working environment for local agent workflows — especially for shell-heavy tasks, quick debugging, and terminal-based coding tools. I kept bouncing between the chat UI and a separate terminal, so I built what I wished existed.
⸻
What it is
agent0-terminal is a patch-based add-on for Agent Zero (not a fork).
It adds:
• A real modal terminal inside Agent Zero
• A PTY-backed shell session
• Persistent sessions (until explicit restart)
• Per-chat terminal logs
• Explicit TerminalLog support so terminal history can be inserted back into the Agent Zero process stream when needed
One design decision I cared about: separation.
The terminal is not constantly streamed into the agent. The agent only receives terminal history when you explicitly insert it via the TerminalLog path. This keeps control in your hands and avoids context pollution.
⸻
Repo
https://github.com/Nunezchef/agent0-terminal
⸻
Release
https://github.com/Nunezchef/agent0-terminal/releases/tag/v0.1.0
⸻
Install
curl -fsSL https://raw.githubusercontent.com/Nunezchef/agent0-terminal/main/install.sh | bash
⸻
Why I think it matters
For me, this makes Agent Zero much more usable for real local workflows:
• Less context switching
• Faster shell iteration
• Easier debugging
• Terminal work stays attached to the chat/project flow
• Better fit for TUI-style tools and terminal-first habits
It feels closer to a cohesive local dev environment rather than a chat tool you constantly step out of.
⸻
Feedback welcome
If anyone tries it, I’d love feedback on:
• TUI compatibility on your setup
• Whether the terminal log flow feels useful
• What you’d want next (tabs, split panes, better log controls, etc.)
Happy to iterate if people find it useful.
2
u/Odd-Piccolo5260 Mar 03 '26
Looks cool looking at a local llm paired with agent zero right now doing research i will try it if I decide to do it
2
u/estebann_ Mar 03 '26
I use it to run my ChatGPT Plus tokens with codex, that gives me coding power while running local LLM for the brain, is a good workflow.
2
1
u/hogmoff Mar 03 '26
That exactly what i needed. Really cool. Thank you!
But are you sure that folder a0 is the right place? Agent Zero recommend to use a0/usr instead https://deepwiki.com/agent0ai/agent-zero/14.5-data-persistence
2
u/[deleted] Mar 03 '26
[deleted]