aegis
A web-native workplace for coding agents. aegis serve runs Claude Code sessions on
your machine and serves them to browser tabs; agents in it get monitors, queues of
workers and handoffs over MCP.
Install and run
uv tool install aegis-harness
cd ~/your/project # the nearest ancestor with .aegis.yaml is the root
aegis serve # prints a URL with its token; open it
aegis serve --port 8742 --host 127.0.0.1 are the defaults. The token is kept in
.aegis2/state/token and reused across restarts; delete the file to rotate it.
Anything but loopback must be asked for with --host.
Configuration
aegis reads two maps from .aegis.yaml at the root:
default_agent: opus
agents:
opus: {model: opus, effort: high, permission: full}
haiku: {model: claude-haiku-4-5-20251001, effort: low, permission: read}
queues:
general: {agent: opus, max_parallel: 5}
permission is read (plan mode), write (accept edits), auto or full
(bypass permissions). Only Claude Code profiles run today.
What you get
- Sessions in tabs. The tab bar is the server's open sessions, the same in every browser; each browser orders them by drag. Fleet is the home view: a card per session and the archive below it.
- Lazy resume. A restart brings sessions back stopped; the next prompt resumes
each with
claude --resume. Stop ends a process and keeps the tab; Close archives the session for every browser; Reopen brings it back. - A transcript that reads well. Tool rows with one-line verdicts, failures open, diffs for edits, rendered Markdown, a prompt sent mid-turn shown pending until Claude reads it, Esc to interrupt. Three themes: Ink, Logbook, Syalia.
- Tools for agents at
/mcp, namedmcp__aegis__<verb>:monitor_start,monitor_cancel,monitor_list,queue_enqueue,task_status,task_cancel,task_resume,peer_handoff,peer_read,session_list,session_rename,meta. Each session'sclaudeconnects with its own token, so no tool asks who is calling.
Before 2.0
Until 2.0, aegis was a terminal app (a Textual TUI with a daemon, queues,
workflows, schedules and more). That tree is kept under legacy/ as reference and
is not installed. pip install "aegis-harness<2" gets the last release of it.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for aegis-harness 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aegis_harness-2.0.0.tar.gz | 396.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aegis_harness-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 730.2 kB
Release files / aegis_harness-2.0.0.tar.gz
| Download URL | aegis_harness-2.0.0.tar.gz |
|---|---|
| Size | 396.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec45bd43923d47dbcf4401b7e288a105da452934c44a3de01288aa40485cf05c
|
|
BLAKE2b-256 checksum How to use checksums |
b4b884a72764ac1d4932063a888f02a4553bce5d775ff12f78b8090843fde50b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / aegis_harness-2.0.0-py3-none-any.whl
| Download URL | aegis_harness-2.0.0-py3-none-any.whl |
|---|---|
| Size | 333.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
10c58a749d4a7f6e7e9354a1edd681056d80af97f047afa932105c91da3d9bbf
|
|
BLAKE2b-256 checksum How to use checksums |
7101a814190226fd5582acf001eb4ab615c4390b7c80b0454c64d336bd15275c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
