eforge 1.0.6

Codebase observation graph and mapping tools

eforge

Codebase observation graph for developers. Map your codebase. Track concepts. Find relationships.

Install

pip install eforge

Project bootstrap (manifest + tasks)

For declaration-graph workflows, initialize the project once:

cd your-project
eforge init
eforge task add --title "Map auth module" -y
eforge task list

eforge console (declare / search / status on the manifest graph) needs the full forge compiler runtime — monorepo checkout or a future eforge[compiler] extra. The PyPI wheel is standalone for init, task, node, schema, and error.

No setup needed

Just start adding nodes. .forge/observations/ is created automatically on first use.

cd your-project
eforge node add "AuthSystem" --kind concept/feature -y
eforge node add "auth.py" --kind core/file \
  --file src/auth.py -y
eforge node link "AuthSystem" "auth.py" \
  --rel housed-in \
  --note "core auth logic" -y
eforge node show "AuthSystem"

Commands

eforge node     add, show, list, find, link,
                note, tag, mark, edit, inspect
eforge schema   list, show, create, edit,
                validate, copy, restore
eforge error    lookup, search, list, stats

Your own schemas

eforge ships with built-in schemas for common node types. Add project-specific schemas without touching forge:

eforge schema create game/canvas

This creates .eforge/schemas/domain/game/canvas.yaml. Your schema is immediately available:

eforge node add "PixelCanvas" --kind game/canvas
# SchemaPrompt uses YOUR schema properties

Schema search order:

1. .eforge/schemas/ (your project)
2. forge built-ins

Built-in kinds: concept/feature, core/file, ui/screen, ui/variant, ui/component, architecture/session, architecture/boundary, data/model, data/table, data/rpc, code/class, code/function, code/module

Node types

concept/feature planned features, systems, capabilities
core/file       source files

Relationship types

housed-in       concept → file
relates-to      concept → concept
depends-on      A needs B
implements      code implements concept
raises          code raises error

Storage

.eforge/schemas/           project type schemas
.forge/observations/
  nodes/                   one yaml per node
  .cache/                  SQLite index (auto-rebuilt)

No AI required

Works without any AI assistant. Map your codebase manually, one node at a time.