Skip to main content

visualizer-cli

Web workspace for agent-built docs and content: agents author structured documents with charts and diagrams through a CLI, an HTTP API front, and an MCP server, and humans view them in the browser on desktop, phone, or remotely via a served site.

Status: early scaffold. What exists today is the agent-first CLI skeleton (identity and introspection verbs), the mesh identity, the vendored skill kit, and CI/deploy. The document workspace itself is planned.

Quickstart

uv sync
uv run pytest -n auto              # run the test suite
uv run visualizer whoami           # identity from culture.yaml
uv run visualizer learn --json     # self-teaching prompt for agents
uv run teken cli doctor . --strict # the agent-first rubric gate CI runs

The installed console script is visualizer. The program and package are named visualizer-cli, and python -m visualizer_cli also works.

CLI

Verb What it does
whoami Report this agent's nick, version, backend, and model from culture.yaml.
learn Print a structured self-teaching prompt.
explain <path> Markdown docs for any noun/verb path.
overview Read-only descriptive snapshot of the agent.
doctor Check the agent-identity invariants (prompt-file-present, backend-consistency).
cli overview Describe the CLI surface itself.

Every command supports --json. Results go to stdout, errors/diagnostics to stderr (never mixed). Exit codes: 0 success, 1 user error, 2 environment error, 3+ reserved. The CLI is cited from teken (afi-cli) and the runtime package has no third-party dependencies.

Roadmap

Planned. None of the items below is built yet.

  • Document model: structured documents made of prose, chart, and diagram blocks.
  • Three agent fronts over one model: CLI authoring verbs, an HTTP API, and an MCP server, all with the same capabilities.
  • Browser viewer: responsive on desktop and phone, and servable remotely.
  • Interactive diagrams (#1): render architecture diagrams as pan/zoom React Flow graphs, exported as standalone HTML, with Mermaid kept as the source and fallback. The first target is the embodiment layer diagram (Surface → embodiment daemon → lobes gateway roles → eidetic/coherence memory).

Development

Check Command
Tests uv run pytest -n auto (coverage floor 60%)
Format / lint uv run black --check visualizer_cli tests scripts, uv run isort --check-only visualizer_cli tests scripts, uv run flake8 visualizer_cli tests scripts
Security uv run bandit -c pyproject.toml -r visualizer_cli, python3 scripts/scan-secrets.py
File length python3 scripts/check-file-length.py (400-line cap)
Markdown markdownlint-cli2 "**/*.md"
Harness configs uv run python scripts/harness-smoke.py --stage all --require config

File length limit. No tracked source file may exceed 400 lines. pyproject.toml [tool.file-length] sets the cap (max-lines = 400) and the checked extensions (file-types: .py, plus .js/.jsx/.ts/.tsx for the planned frontend). The CI lint job enforces it. The vendored skills are exempt. Long files are split into modules instead of exempted: scripts/_harness_smoke/ is the example.

Every PR bumps the version, including docs- or CI-only PRs; the version-check job blocks merge otherwise. A push to main that touches the package publishes to PyPI through Trusted Publishing, and PRs publish a TestPyPI dev build.

Prompt files by harness

Four harnesses, four root files, no shared base. Each file is read by exactly one harness:

Harness File(s)
Claude Code CLAUDE.md (the fullest write-up; read it first)
Pi / associate AGENTS.override.md + .pi/SYSTEM.md
colleague AGENTS.colleague.md
Qwen Code QWEN.md

There is intentionally no AGENTS.md at the root. It would shadow the Pi and colleague files, and CI fails if one appears. All four harnesses can be used interactively at the same time.

culture.yaml's backend (claude) selects only the mesh resident, the agent the Culture daemon starts and the one steward doctor checks. It does not limit which harness you can run in this clone. See docs/harness-selection.md and docs/automation-contract.md.

Skills

.claude/skills/ vendors the guildmaster skill kit verbatim (cite-don't-import). .qwen/skills, .colleague/skills and .pi/skills are symlinks onto it. Provenance and the re-sync procedure are in docs/skill-sources.md.

The gate section

culture.yaml carries a top-level gate section that declares how to set up and test this repo, so tooling (for example a PR-fixer that re-runs checks before pushing) needs no per-repo knowledge:

gate:
  setup:
  - [uv, sync]
  test:
  - [uv, run, pytest, -n, auto]

Each command is an argv list (never a shell string), and commands run in order from the repo root. Culture's loader ignores unknown top-level keys.

License

Apache 2.0. See LICENSE.

Metadata

Release files for visualizer-cli 0.11.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 visualizer-cli 0.11.0
File Size Uploaded Provenance Actions
visualizer_cli-0.11.0.tar.gz 244.7 kB Without provenance Details for visualizer_cli-0.11.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for visualizer-cli 0.11.0
File Interpreter ABI Platform Actions
visualizer_cli-0.11.0-py3-none-any.whl Python 3 none any Details for visualizer_cli-0.11.0-py3-none-any.whl

Total release size: 269.8 kB

Release files / visualizer_cli-0.11.0.tar.gz

Download URL visualizer_cli-0.11.0.tar.gz
Size 244.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e6f3882b9bdbf778819c8cda1c255e39a924f99ca77c745687854ed406991852
BLAKE2b-256 checksum
How to use checksums
4ae73ed61f55a9ff5455abeded0bb71307a57df88ff6c5ffde20dff4fd1c6ff0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / visualizer_cli-0.11.0-py3-none-any.whl

Download URL visualizer_cli-0.11.0-py3-none-any.whl
Size 25.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
32f429afa287be47db4bd41f2db62483b81407b022acf21aee07c1edef1fd021
BLAKE2b-256 checksum
How to use checksums
151db34ecdf641c9f869f8e2e7c84c0de10c7748a4a01efeeca3a1c19d459fbf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for visualizer-cli 0.11.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

0.11.0 This release

2 release files No provenance

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