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

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.6
File Size Uploaded Provenance Actions
agenturm-0.1.6.tar.gz 289.1 kB With provenance Details for agenturm-0.1.6.tar.gz

Built distribution (wheel)

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

Total release size: 491.8 kB

Release files / agenturm-0.1.6.tar.gz

Download URL agenturm-0.1.6.tar.gz
Size 289.1 kB
Tags Source
SHA-256 checksum
How to use checksums
89be4aeb64cb61a7f7d6f1e5833452b3e2bafffef89307403a6b6eafa099b63a
BLAKE2b-256 checksum
How to use checksums
d35647512090ce352b5968ce6860c8270d8b4ba8049f9374004d5e2eab74bbde
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 Oct 30, 2026.

Transparency log

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

Download URL agenturm-0.1.6-py3-none-any.whl
Size 202.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7878007f3e3fc22f0e89c518d5b45b2c5b8bdbbc48ebfaca783d6c0fb4b71d05
BLAKE2b-256 checksum
How to use checksums
ed795f96f437bf820720616803c0e9cd681e92d2856767068b2cb4f587774b6a
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 Oct 30, 2026.

Transparency log

Security for agenturm 0.1.6

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.6.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 Oct 30, 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