GoForge
Commands
Every GoForge subcommand and what it does.
GoForge is a single binary with poly-style arguments: key:value and :flag.
Add color-mode:none to any command to disable ANSI color.
| Command | Purpose |
|---|---|
create | Scaffold a workspace, component, base, or project |
info | Brick × project matrix, with changed bricks/projects marked (:loc for line counts) |
check | Validate structure, the interface boundary, worker-type rules (declared and inferred), and project deps |
classify | Declared vs. inferred vs. effective worker type per brick (explain:<brick> for the why) |
deps | Brick dependencies, forward and reverse (brick: / project:) |
diff | Files, bricks, and projects changed since the stable point (since:) |
test | Run tests for changed bricks/projects (:all, :dev, brick:, project:) |
libs | Third-party libraries and which bricks use them |
ws | Workspace as YAML data (get:KEY.PATH, out:FILE) |
migrate | Bootstrap goforge config for an existing Go module |
shell | Interactive command shell |
version / help | Tool version / usage |
Examples
goforge create component name:user interface:api
goforge info :loc
goforge test :all
goforge deps brick:user
goforge diff since:main
goforge ws get:components.user.type
Migrating an existing module
Already have a Go module? Bootstrap GoForge config in place:
cd your-module
goforge migrate
goforge check