Skip to content

KnossosThe labyrinth mapped once

On screen beside Claude Code, and in the notes your agent reads while it works.

Claude Code with the Knossos pane open beside the session on its Overview tab: headline counts, composition by boundary, language and kind, dependency concentration and cross-boundary flowsClaude Code in its light theme with the Knossos pane open beside the session on its Overview tab, drawn in that theme's colours
/knossos opens the pane beside the session. This is the Overview of the Knossos repository.Watch it open (animated, 1.2 MB)

Knossos scans a repository into a local graph of its components and the relationships between them, each with the file and line that proves it. In Claude Code, /knossos opens that graph as a live pane beside your session, and the same graph answers 40 MCP tools and a CLI for Claude Code, Codex or any MCP client.

Facts that static analysis cannot prove are labelled with their confidence and origin. Nothing in the scan installs dependencies, imports a module or boots a framework.

What the pane shows ​

◎Blast radius
ResultEnvelope's detail: its dependencies, and its blast radius as nested rings one, two and three or more hops out, with the tests that reach each ring

What a change to one component reaches, ring by ring, and whether a test reaches each ring.

Details and blast radius
→Routes
A route from ServeCommand::run to ResultEnvelope: two routes found, the strongest drawn as boxes down the pane with the call and its file and line on each hop

How one component reaches another, every hop with the file and line it is written at.

Routes between components
✎Notes
The Notes tab: 109 notes as a tree of the boundaries they live in, each in its colour with its count, the one holding the newest note open on its folders and notes, each with its author, first line and date

Facts you and the model keep about components, filed by where they live, with the ones that need you first.

Notes on components
■In a browser
The web client's Overview, with the Knossos sigil, project statistics, composition charts and dependency views in the browser's dark application frame

The same pane in a browser tab with knossos web, for one project and no Claude Code session around it.

The pane in a browser

Install ​

A native install needs PHP 8.3 or newer with the JSON, mbstring, PDO, PDO SQLite and tokenizer extensions, Node 24 or newer, Python 3.11 or newer and Git, and knossos doctor fails without any of them. When something is missing, the installer stops before it writes anything, lists what is missing, and names the two ways out: install it, or run the installer with --mode=container, which is experimental and runs Knossos in a container with Docker or Podman. This installs the latest release natively:

sh
curl -fsSL https://github.com/AraneaDev/knossos/releases/latest/download/install.sh | sh

The installer grants the folder you run it from to the list of projects Knossos may scan, except / and your home folder when you pipe it as above; set KNOSSOS_ALLOW_ROOT to grant another folder, or pass --no-roots to grant none. Installation covers installing from a checkout or in Docker, and what to do when it does not start.

Where to go next ​