Skip to main content

Agenturm tower-and-lens logo and the headline: Know what your agents are doing. Local observability for Codex, Claude Code, OpenCode, Pi, and OpenTelemetry agents.

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

CI Terminal interface Local by default MIT license

The view from your terminal

29-second animated walkthrough of Agenturm's synthetic terminal: agent sessions, recorded prompts, MCP evidence, and a linked trace.

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 in Today with running work, sessions that need you, and reported completions awaiting your review. History keeps earlier work available. Ready for review means the agent reported completion; it does not verify the changes or tests. Select a task to inspect its evidence, and press r to mark that run reviewed. See the daily workflow guide.

Press b for Saved tasks: keep a brief across sessions, link specific runs, capture workspace changes, and prepare a handoff for your next agent. Saved tasks also work offline through agenturm task. See saved tasks and handoffs.

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.

Each agent has a task line and a muted source/current-work line, grouped by an alternating background. Roomy terminals add a line of space between agents; compact terminals keep the two content lines. Selection stays distinct from the alternating rows.

Agenturm is a monitor, not a controller. Reply to agents and approve requests in their own terminals.

The session inspector opens on Overview: the latest agent-reported update, recorded work and results, and delegated children. Prompts lets you read one request at a time, with runtime context separated and original captured text always available. Details holds IDs, usage and provenance. On the inspector tabs, use ← / → to choose a section and Enter to read. Ctrl+← / Ctrl+→ switch sections from the reader; m also cycles them. Use Tab / Shift+Tab for controls, [ / ] for requests, and z for original text. Reading positions survive section changes. See the assessment, reviewed plan and validation report.

Open Review from Overview for recorded checks, later edits and explicit coverage. w opens the attention inbox; seen requests stay pending until native evidence resolves them. b opens Saved tasks, including structured briefs and versioned decisions for a reviewed handoff. See the joint RFC implementation plan and saved-task guide.

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 Choose Working first, Updated, or Status sorting
/ Search the current view
e Expand details
Ctrl+← / Ctrl+→, m Switch inspector sections
Tab / Shift+Tab Move between inspector controls
t Follow the linked trace
Esc / Alt+← Return or navigate back
c Copy details
d Open collection diagnostics
w Attention inbox, completion review, task alerts, and terminal handoff
b Saved tasks: notes, linked runs, workspace capture, and handoff
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

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.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agenturm 0.2.0
File Size Uploaded Provenance Actions
agenturm-0.2.0.tar.gz 453.5 kB With provenance Details for agenturm-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agenturm 0.2.0
File Interpreter ABI Platform Actions
agenturm-0.2.0-py3-none-any.whl Python 3 none any Details for agenturm-0.2.0-py3-none-any.whl

Total release size: 761.8 kB

Release files / agenturm-0.2.0.tar.gz

Download URL agenturm-0.2.0.tar.gz
Size 453.5 kB
Tags Source
SHA-256 checksum
How to use checksums
287a1fb3b8a435f9cc960ba0423b6714a921f1039130a80fc75bc8ddd6b15a3d
BLAKE2b-256 checksum
How to use checksums
75695fb758682e5315af9cdf25e67366ffe6d33319e90e985d25439b4c857bc8
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 12, 2026.

Transparency log

Release files / agenturm-0.2.0-py3-none-any.whl

Download URL agenturm-0.2.0-py3-none-any.whl
Size 308.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
401183191bdc80e08e5adb02035603c8f042459fb8ff88b97cdb428293612645
BLAKE2b-256 checksum
How to use checksums
ec2d9701f1c9e7f0eac972eeb747c987d77efa303dfc8afef7076dd7ffc0a329
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 12, 2026.

Transparency log

Security for agenturm 0.2.0

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.

Select from 2 files

Attestation for agenturm-0.2.0.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 12, 2026.

Transparency log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page