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+, Git, and uv.

On macOS or Linux, install and launch:

curl -fsSL https://www.agenturm.dev/install.sh | bash
agenturm

Review the installer before running it. On Windows—or if you prefer to install with uv directly:

uv tool install --force git+https://github.com/abhishekash/agenturm
agenturm

Or try it once without installing the command:

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.

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
/ 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.5

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.5
File Size Uploaded Provenance Actions
agenturm-0.1.5.tar.gz 250.1 kB With provenance Details for agenturm-0.1.5.tar.gz

Built distribution (wheel)

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

Total release size: 424.9 kB

Release files / agenturm-0.1.5.tar.gz

Download URL agenturm-0.1.5.tar.gz
Size 250.1 kB
Tags Source
SHA-256 checksum
How to use checksums
208d50fdb6605d9ed2c1840bb36e5e5ccc5d7d77ccd0aa9f51a1da630b59be95
BLAKE2b-256 checksum
How to use checksums
c1601c3fc139420abd37f82e369a5ce4d97f9582ab3d837b39f6676138ff8a23
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.5-py3-none-any.whl

Download URL agenturm-0.1.5-py3-none-any.whl
Size 174.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
90b42f398effe30a282b13180a1c8006ecd9fb4720ec88aaac4ce94aa2227cd6
BLAKE2b-256 checksum
How to use checksums
861f9258eb4d2e66cb7ffa47e31489a080ce3454ff068d10b46a3ed673908b57
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.5

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