Talocode ArchWiki

Turn any codebase into a visual architecture wiki for humans and agents.

What it does

Scans a repo, detects routes/services/auth/database/build patterns, and generates:

• architecture.json — machine-readable graph for agents
• architecture.html — interactive dark visual wiki for humans

Install

pip install talocode-archwiki

Usage

# Scan current directory
archwiki .

# Scan specific repo
archwiki /path/to/repo

# Specify output directory
archwiki /path/to/repo /path/to/output

Python SDK

from archwiki import scan

result = scan("/path/to/repo")
print(result["json"]["stats"])
# {"total_files": 86, "total_nodes": 31, "total_edges": 0, "total_flows": 2}

Output

architecture.json

Machine-readable graph with nodes, edges, and flows:

{
  "name": "my-app",
  "nodes": [
    {
      "id": "route_src/routes.ts",
      "name": "routes",
      "type": "route",
      "file": "src/routes.ts",
      "description": "route in routes.ts",
      "code_ref": "app.get('/api/users', ...)"
    }
  ],
  "flows": [
    {
      "id": "api_request",
      "name": "API Request",
      "steps": [...]
    }
  ]
}

architecture.html

Interactive dark visual wiki with:

• Flow visualization (nodes + connections)
• Right sidebar (Flows + Steps)
• Click a node → see code reference
• Click a flow → see numbered steps
• Dark charcoal + gold accent design

Talocode ecosystem

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT © Talocode