Follow Codex, Claude Code, OpenCode, and Pi from one terminal.
See recorded progress, inspect tool calls, and find what needs your attention.
Try the interactive demo → · Documentation · Privacy boundaries
The view from your terminal
Actual terminal UI · synthetic example records · Watch or download the full 29-second video · Rebuild the walkthrough
Start here. Stay in your terminal.
Requires Python 3.11+ and uv.
Run it once without installing:
uvx agenturm
Or install the command:
uv tool install agenturm
agenturm
agenturm is published on PyPI. The installer wraps the same uv tool install for macOS and Linux. To run the latest unreleased source instead:
uvx --from git+https://github.com/abhishekash/agenturm agenturm
Find what needs your attention
Start with your recent supported agent sessions. Select a record, inspect the evidence, and follow its trace—all in a keyboard-first terminal interface.
| Start with… | Then inspect… |
|---|---|
| Agents — sessions, projects, status, and last update | A session's task, recorded progress, current work, and reported waits |
| Activity — what happened in a session | Recorded prompts, messages, shell commands, file changes, and errors |
| MCP calls — tools and servers | Arguments, responses, failures, duration, and linked execution |
| Traces — how a run fits together | Parent and child operations, model usage, and errors |
| Host and metrics — runtime and reported usage | Known local processes, host details, and recorded OTLP metrics |
Recent supported Codex, Claude Code, OpenCode, and Pi records are discovered locally—without restarting your agents. Other supported tools can send telemetry through OpenTelemetry to the local receiver.
When a runtime records an exact delegation, Agents shows an expandable tree and keeps every child independently inspectable. A completed parent stays completed while its workers continue, and a collapsed branch carries descendant activity and attention counts. Press f to switch to the flat list. See agent hierarchy support and limits.
Agenturm is a monitor, not a controller. Reply to agents and approve requests in their own terminals.
Keyboard first
| Key | Action |
|---|---|
1–7 |
Switch views |
↑ / ↓, Enter |
Select and inspect a record |
→ / ← |
Expand a branch / collapse or move to the parent |
f |
Switch the Agents tree and flat list |
o |
Toggle updated-time sort direction |
/ |
Search the current view |
e |
Expand details |
t |
Follow the linked trace |
Esc / Alt+← |
Return or navigate back |
c |
Copy details |
d |
Open collection diagnostics |
x |
Preview and export selected evidence |
q |
Quit |
Four terminal themes
Press Ctrl+P → Theme to choose Current (Alpine Ember), Bright, Dark, or Solarized. The selected palette carries through panels, tables, controls, and evidence inspectors.
Local by default
Supported records and telemetry are stored in local SQLite. The built-in receiver listens on 127.0.0.1:14318. Local monitoring and recorded-progress summaries need no account or API key.
Captured messages, commands, and tool results can contain sensitive project information. Recognizable credentials are redacted on a best-effort basis. Use --metadata-only to omit native session text, commands, and outputs from future ingestion. Read what is collected and where it goes.
Recorded-progress summaries work locally. Optional AI summaries call your configured provider only when explicitly requested. The documented session evidence can include task and action text; review AI summary setup and data before enabling one.
Integrations and documentation
- Complete usage guide — installation, local discovery, keyboard shortcuts, and troubleshooting.
- Integrations guide — Pydantic AI, Google ADK, Gemini CLI, and other OTLP agents.
- Python integrations and automatic SDK capture
- JavaScript client
- Receiver and OTLP configuration
- Resource budgets and benchmarking
- Capture and privacy boundaries
- Brand and terminal themes
For conversational queries over recorded MCP executions, see SpanHound, the companion MCP tool.
Develop
git clone https://github.com/abhishekash/agenturm.git
cd agenturm
uv sync
uv run agenturm
uv run python -m unittest discover -s tests -v
See CONTRIBUTING.md for development and demo production. Issues and focused pull requests with clear reproductions are welcome.
Upgrading from Agent Observatory
Agenturm is the new name. Install from this repository to get the agenturm command. Existing Python imports (observatory), OBSERVATORY_* settings, telemetry keys, and observatory.db history continue to work. The old executable aliases are intentionally not installed; use agenturm. The source install above works independently of PyPI publication.
Agenturm is open source under the MIT license. Read more at agenturm.dev.
Metadata
Release files for agenturm 0.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agenturm-0.1.7.tar.gz | 315.9 kB | With provenance | Details for agenturm-0.1.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agenturm-0.1.7-py3-none-any.whl | Python 3 | none | any | Details for agenturm-0.1.7-py3-none-any.whl |
Total release size: 532.4 kB
Release files / agenturm-0.1.7.tar.gz
| Download URL | agenturm-0.1.7.tar.gz |
|---|---|
| Size | 315.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
47aae948e00c72f1402ee64aeb5b513809e5acd40428bf2761d1493128043d3e
|
|
BLAKE2b-256 checksum How to use checksums |
3dac23c5f47837b94e071ad726ce9fef934349f45015b53e285fbb5f5aa9e883
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / agenturm-0.1.7-py3-none-any.whl
| Download URL | agenturm-0.1.7-py3-none-any.whl |
|---|---|
| Size | 216.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f3d860a35763e912908bf5cf250d17676217b9ea62bdb65b419619609cd6386
|
|
BLAKE2b-256 checksum How to use checksums |
813eef7eba92af26eefcef11b79b2880d5a3d1cfd5f134d139521693b83db5b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logSecurity for agenturm 0.1.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for agenturm-0.1.7.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.