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

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)

Source distribution for agenturm 0.1.7
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)

Table of built distributions (wheels) for agenturm 0.1.7
File Interpreter ABI Platform Actions
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 log

Release 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 log

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

Select from 2 files

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