PacketCode#

PacketCode is a keyboard-first coding agent that runs in a terminal. It keeps a model conversation, project tools, approvals, background agents and reusable workflows in one interface while leaving normal terminal scrollback intact.

This documentation describes release v0.6.0. See Install for the packaged archives and the build requirements.

PacketCode can read and edit the project where it starts, execute commands, connect to local MCP servers and delegate isolated work. Its permission policy decides whether a requested action is allowed, denied or shown for approval. That policy is not an operating-system sandbox: approved tools run as your user.

Supported workflows#

• Interactive coding sessions in the current project.
• One non-interactive turn from a script or CI job with packetcode run.
• Hosted providers, Codex sign-in, local Ollama and custom OpenAI-compatible endpoints.
• Resume, rename, compact and undo within a stored session.
• Agent Skills and command files discovered from user and project scopes.
• Stdio MCP tools with the same permission checks as built-in tools.
• Background sub-agents and TOML workflows with bounded parallelism.
• Remote projects registered as Packet Computers over SSH.
• An optional local ACP stdio server for compatible clients.

Start here#

1. Install PacketCode.
2. Complete Your first session.
3. Review Permissions before allowing writes or commands.
4. Use Troubleshooting when a provider or tool fails.

PacketCode is pre-1.0 software. Keep project work in Git, review every diff and pin release versions in environments where reproducibility matters.