postal
View on GitHubAn open-source, terminal-based AI coding agent that reads your code, calls tools, and helps you build.
Postal is an open-source Python terminal AI coding agent that plans, edits, runs and reviews code using any model via OpenRouter. It offers a full-screen TUI, built-in file/bash/web/MCP tools, specialized sub-agents, approval policies, and checkpointed resumable sessions.
Use Cases
Terminal-based AI coding assistantReading and editing files in a repoRunning shell commands with approval policiesDelegating to specialized sub-agents (code reviewer, test writer, debugger)Connecting external MCP servers as tool sourcesResuming and rewinding saved coding sessionsSingle-shot scripting with `postal "prompt"`Loading SKILLS.md capability packsWeb search and URL fetching during codingSwitching models mid-session via slash commands
Built With
- Language
- Python
- Frameworks
- Rich · Click · Pydantic · FastMCP · OpenAI Python SDK · prompt-toolkit · tiktoken · httpx · setuptools · Docker
Tags
coding-agent · terminal · tui · cli · openrouter · sub-agents · mcp · sessions · approval-policy · skills · tool-use · python · rich · context-compaction · code-editing · shell-execution