Metadata-Version: 2.5
Name: agent6
Version: 0.0.43
Summary: A coding agent that jails model commands and uses editable state machines for long-running tasks.
Project-URL: Documentation, https://agent6.dev
Project-URL: Homepage, https://agent6.dev
Project-URL: Source, https://github.com/agent6-dev/agent6
Author: Eric Lesiuta
License: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: argcomplete<4,>=3
Requires-Dist: httpx2<3,>=2.16.0
Requires-Dist: markdown-it-py==4.2.0
Requires-Dist: pydantic<3,>=2.14.1
Requires-Dist: ruff<1,>=0.17.1
Requires-Dist: textual<9,>=8
Requires-Dist: tree-sitter-language-pack==1.22.1
Requires-Dist: tree-sitter==0.26.0
Requires-Dist: ty<0.1,>=0.0.90
Description-Content-Type: text/markdown

# agent6

A coding agent with sandboxed commands, resumable sessions, and editable workflows.

<table>
  <tr>
    <td align="center" width="50%" valign="top">
      <a href="https://agent6.dev/screenshots/out/hero-tui.gif"><img src="https://agent6.dev/screenshots/out/hero-tui.gif" alt="Terminal UI showing a coding task, command approval, verification, and changes"></a>
      <br><sub><b>agent6 tui</b><br>terminal interface</sub>
    </td>
    <td align="center" width="50%" valign="top">
      <a href="https://agent6.dev/screenshots/out/hero-web.gif"><img src="https://agent6.dev/screenshots/out/hero-web.gif" alt="Web UI showing sessions, tool details, and sandbox configuration"></a>
      <br><sub><b>agent6 web</b><br>browser interface for desktop or phone</sub>
    </td>
  </tr>
</table>

- Runs commands in a [Linux sandbox](#security); you set file and network access.
- Routes each role to a hosted, local or subscription model.
- Resumes or forks a saved session from an earlier turn.
- Runs your verification command and marks an unverified tree.
- Reviews the diff with a model panel; blocking findings stop the merge.
- Runs in a worktree, or as [parallel attempts][parallel-runs] in clones, ranked for you; a top-level run may dispatch children itself when `harness.parallel.tool` is on.
- Defines workflows as [TOML state machines][state-machines] with recovery and replay.
- Follows `AGENTS.md` and [SKILL.md packs][skills]; [MCP servers][mcp] are opt-in.
- No telemetry unless you [export it][telemetry], and no automatic updates.

Also available as a [streaming CLI][cli-demo] and through [ACP editor integration][acp].

## [Installation][installation]

Sandboxing supports **Linux on x86_64 and aarch64**; macOS runs without it, and Windows users should use WSL.

Install from [PyPI](https://pypi.org/project/agent6) with [uv](https://docs.astral.sh/uv/getting-started/installation/) or [pipx](https://pipx.pypa.io/stable/how-to/install-pipx.html), then connect a provider and select a model:

```sh
uv tool install agent6      # or pipx install agent6
agent6 connect              # configure a provider
agent6 model default        # choose the required default model
```

Use Anthropic or any OpenAI-compatible endpoint, including OpenAI, OpenRouter, Ollama, vLLM, llama.cpp, and LM Studio.
A provider entry can also use the Responses API (`providers.<name>.backend = "responses"`) or sign in at a [configured OAuth issuer][oauth].
For subscriptions, replace `agent6 connect` with `agent6 connect chatgpt` or `agent6 connect claude`; the latter uses your installed, signed-in Claude Code binary.
`agent6 completions` installs tab completion for your shell.

## [Usage][usage]

A run edits your current checkout.
Checkpoint commits go on a separate `agent6/<id>` branch; checkpointing leaves your current branch's history and index in place.
For a separate checkout, use `agent6 run --worktree "your task"`, which starts from committed HEAD without copying uncommitted changes or untracked dependencies.

```sh
cd your-repo
agent6 check                # check configuration and sandbox support
agent6 run "your task here"
```

Commands ask for approval by default.
After the task finishes, enter another instruction or type `/exit`.

Inspect the latest session, then merge its recorded changes when ready:

```sh
agent6 sessions show        # status and verification result
agent6 sessions diff        # recorded changes
agent6 sessions merge       # merge into the run's starting branch
```

Other commands:

| Command | Purpose |
| --- | --- |
| `agent6 plan "task"` | plan a change; `agent6 run --from <plan-id>` carries it out |
| `agent6 ask "question"` | ask about the repository |
| `agent6 attach <id>` | follow a live session |
| `agent6 steer <id> "instruction"` | direct the next steps |
| `agent6 sessions findings <id>` | list a session's review findings |
| `agent6 sessions receipt <id>` | print the recorded tests, execution environments, review outcome, the children it dispatched and how to revert |
| `agent6 stop <id> --after-turn` | stop after the current turn |
| `agent6 resume <id>` | continue an interrupted run |
| `agent6 fork <id> --at-turn 7` | fork a coding run from an earlier turn into a separate worktree |
| `agent6 telemetry export` | export session journals as OpenTelemetry signals or a Prometheus textfile |
| `agent6 pack` | copy your config, secrets, sessions and memory into the workspace before a sync |
| `agent6 unpack` | move the packed files into the new home |

To give a finished run more work, use `agent6 resume <id> --steer "next task"`.

## [Configuration][configuration]

`agent6 config show` prints effective settings and where each value came from.
Changes are global unless you add `--repo` for a repository override, for example:

```sh
agent6 config set --repo harness.verify.command '["uv", "run", "pytest"]'
```

The worker, planner, reviewer, and helper inherit each unset model, effort, and temperature from the required `models.default`.
[Budgets][budgets] limit spending, tokens for unpriced calls, and supported subscription usage.

## [Security][security]

agent6 confines only the model's commands: in a jail on your host under `full` and `partial` isolation, or inside the dev container you select; the agent6 process stays trusted, holds your provider credentials, and connects to your configured providers.
The repository stays at its real path, and the jail sees your system toolchains and `~/.local/bin` read-only.

`sandbox.isolation` names the command mode; `auto`, the default, picks the strongest of `full`, `partial` and `none` the host allows and warns when it falls back:

- `full`: commands cannot read your provider keys or the secrets file, `.git` is read-only to them (`sandbox.protect_git = "auto"`, `git.control = "agent6"`), and they get a private network (`sandbox.network = "auto"`).
- `partial`: commands cannot read your keys or the secrets file, but they share agent6's network and can write `.git`.
- `none`: no confinement.
- `container`: commands run inside the dev container that mounts your workspace, found by its labels or named in `[container]`; the runtime is the boundary, and agent6 adds no confinement there.

Commands ask for approval by default (`sandbox.run_commands = "ask"`).
agent6's own git never pushes, rewrites history or runs `reset --hard`, and no config key turns that on.
MCP is off by default, and locally spawned servers use the command sandbox unless explicitly configured otherwise.
`agent6 check sandbox` shows the effective file and command boundaries, network and approval settings, and live probe results.

### Running agent6 itself in Docker or Podman

- Docker gives `partial` by default and allows `full` with both `--security-opt seccomp=unconfined` and `--security-opt apparmor=unconfined`.
- Rootless Podman allows `full` with no flags ([rootful Podman][security]).

On Ubuntu, `full` under Docker also needs the host to allow the jail launcher to use unprivileged user namespaces ([Installation][installation]).

[acp]: https://agent6.dev/acp/
[budgets]: https://agent6.dev/config/#budget
[cli-demo]: https://agent6.dev/screenshots/out/hero-cli.gif
[configuration]: https://agent6.dev/config/
[installation]: https://agent6.dev/installation/
[mcp]: https://agent6.dev/config/#mcp-and-mcpserversname-optional
[oauth]: https://agent6.dev/config/#configured-oauth
[parallel-runs]: https://agent6.dev/architecture/#parallel-runs
[security]: https://agent6.dev/security/
[skills]: https://agent6.dev/config/#skills
[state-machines]: https://agent6.dev/state-machines/
[telemetry]: https://agent6.dev/cli/#telemetry-export
[usage]: https://agent6.dev/usage/
