eforge 1.0.4

Codebase observation graph and mapping tools

eforge

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

Install

pip install eforge

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 .forge/observations/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. .forge/observations/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

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

No AI required

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