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
.aegis/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.1
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.1.tar.gz | 396.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aegis_harness-2.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 731.0 kB
Release files / aegis_harness-2.0.1.tar.gz
| Download URL | aegis_harness-2.0.1.tar.gz |
|---|---|
| Size | 396.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f9bb2e8ed58b29a5826dd1500089d029411a1f3a8928d21acd95bdbdfbdd99cc
|
|
BLAKE2b-256 checksum How to use checksums |
6b998a1545b507133401fcc2f7b1e4b2af4a81e2dbfb5cd488044e4cc163e9bf
|
| 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.1-py3-none-any.whl
| Download URL | aegis_harness-2.0.1-py3-none-any.whl |
|---|---|
| Size | 334.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3df4d20518d7384a61118da93ad5872c3efec318fc1e9e2c5f1708b741bc32b5
|
|
BLAKE2b-256 checksum How to use checksums |
b8f07a32ca72e756cce802e1192ea0e5dbad24c12938305fff27613f4d09c0fe
|
| 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}
|
