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

Actual Agenturm terminal showing three synthetic agent sessions, recorded status, recent work, and the selected session's progress.

Actual terminal UI · synthetic example records · Watch 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 previous command is retained as an alias. 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.4

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.4
File Size Uploaded Provenance Actions
agenturm-0.1.4.tar.gz 246.2 kB With provenance Details for agenturm-0.1.4.tar.gz

Built distribution (wheel)

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

Total release size: 418.6 kB

Release files / agenturm-0.1.4.tar.gz

Download URL agenturm-0.1.4.tar.gz
Size 246.2 kB
Tags Source
SHA-256 checksum
How to use checksums
94c7a885e533a3fbe1139d0c5d19c02bf11a28de7649921eec66ee3cdf6a37ab
BLAKE2b-256 checksum
How to use checksums
aba77c71ed17b4537aea08a4708d320f585a433bdb36772385bcd9b6e7cc9f27
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.4-py3-none-any.whl

Download URL agenturm-0.1.4-py3-none-any.whl
Size 172.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d757f59ac52f6c0ffa6cafcb12feff956af5331dc32b72dafd1503d866ba3832
BLAKE2b-256 checksum
How to use checksums
50cd9f1cb088c352feb323bc2e0eb2580395f1e6c2cb0348ef8d5678222161e0
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.4

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