gofasta console

Launches yaegi — a Go interpreter — in the current project directory, with your project on the import path. Useful for poking at a service, running an ad-hoc query, or trying out a library API without writing a throwaway main() and rebuilding.

Usage


gofasta console

Run it from the project root. The command takes no flags of its own.

Prerequisite: yaegi

Yaegi is a third-party interpreter, not a dependency of the CLI, so it is not installed for you. Install it once:


go install github.com/traefik/yaegi/cmd/yaegi@latest

The command looks up yaegi on $PATH and fails immediately with an install hint if it isn’t there. If you just installed it and the lookup still fails, ~/go/bin (or $GOBIN) is not on your PATH — see Installation → Troubleshooting for the one-time fix.

Session


$ gofasta console
Starting gofasta console (yaegi)...
Type Go code interactively. Press Ctrl+D to exit.
 
> import "myapp/app/models"
> u := models.User{FirstName: "Alice"}
> u.FirstName
"Alice"

Press Ctrl+D to exit. Ctrl+C is forwarded to the interpreter, so it interrupts the statement being evaluated rather than killing the terminal session out from under you.

What the interpreter can and cannot do

Yaegi interprets Go rather than compiling it, and that boundary is where surprises live:

cgo is unavailable. Any package that requires cgo will not load. This includes some database drivers — notably the cgo build of SQLite.
unsafe is restricted, so packages reaching into memory layout directly may fail to import.
Generics support depends on the yaegi release you installed; older versions choke on generic code that compiles fine with go build.

When yaegi cannot handle something, write it into a small file and use go run instead. The console is for exploration, not a substitute for the compiler.

Not available in `--json` mode

The console is a REPL: stdin is your keyboard and stdout is the interpreter’s prompts, neither of which can be represented as a structured document. Invoking it with --json therefore fails immediately with the INTERACTIVE_ONLY error code rather than launching a process whose output an agent could not parse:


$ gofasta console --json
{
  "code": "INTERACTIVE_ONLY",
  "message": "console is an interactive REPL and cannot run in --json mode",
  "hint": "this command requires an interactive terminal and cannot run in --json / headless mode; drop --json or invoke a non-interactive equivalent"
}

Agents and CI runners can pattern-match on that code and skip the command instead of hanging on a process waiting for input. For inspection that is scriptable, reach for gofasta inspect, gofasta routes, or the gofasta debug family — all of which emit structured output.

gofasta init
Initialize a cloned or existing Gofasta project by installing dependencies and running code generators.
gofasta dev
Bring the full local environment up with one command — compose services + migrations + Air hot reload, with interactive restart.
gofasta debug
CLI surface for the devtools /debug/* endpoints — requests, SQL, traces, logs, errors, cache, pprof, EXPLAIN, HAR, plus the composed...
gofasta ai
Install per-agent configuration for Claude Code, Cursor, OpenAI Codex, Aider, and Windsurf — permission allowlists, hooks, project rules, and slash commands.
gofasta verify
Run the full preflight gauntlet — gofmt, vet, golangci-lint, tests, build, Wire drift, routes — in one command.
gofasta test
Run go test against the project with gofasta defaults — race detector on, every package, live output, plus shortcuts for short/integration/coverage/run-pattern.
gofasta status
Report the health of the current project — Wire drift, swagger drift, pending migrations, uncommitted generated files, module freshness.
gofasta inspect
Show the full composition of a resource — model fields, DTOs, service methods, controller methods, routes — as structured output.
gofasta inspect-jobs
Static AST scan of app/jobs/ that lists every registered cron job with its schedule from config.yaml.
gofasta inspect-tasks
Static AST scan of app/tasks/ that lists every async task with its wire name, payload shape, and handler/enqueuer presence.
gofasta impact
Reverse-dependency analysis — given a file or import path, list every package that depends on it (directly + transitively) and every Go source file in those packages.
gofasta xrefs
Type-aware reverse symbol lookup — find every reference to a Go func, type, method, var, or const across the current module.
gofasta do
Run a named development workflow — a pre-defined chain of gofasta commands that together accomplish one higher-level task.
gofasta config
Inspect and validate your project's config.yaml — currently the schema emitter, more subcommands to come.
gofasta serve
Run the project's HTTP server in production mode — no Air, no hot reload.
gofasta refactor
Switch a Gofasta project between layered and feature-package layouts without rewriting code by hand.
gofasta migrate
Run database migrations up or down for your Gofasta project, with static analysis (--explain), safe rollbacks (--steps, --all), and dirty-state repair (migrate repair).
gofasta seed
Run database seeders to populate your database with initial or test data.
gofasta db
Destructive database utilities, kept separate from `gofasta migrate` on purpose.
gofasta deploy
Deploy a Gofasta application to a remote VPS via SSH using Docker or a compiled binary, with a health gate and automatic rollback.
gofasta wire
Regenerate Google Wire dependency injection code for your Gofasta project.
gofasta swagger
Generate OpenAPI/Swagger documentation from the `@Summary`, `@Tags`, `@Router`, and `@Param` annotations the scaffold and `g endpoint` emit.
gofasta routes
Print every registered REST route in the project as a formatted table — method, path, and source file.
gofasta doctor
Check system prerequisites, project configuration, and database connectivity.
gofasta upgrade
Self-update the Gofasta CLI to the latest GitHub release.
gofasta version
Print the CLI version, the Go toolchain it was compiled with, and the OS/architecture target.
Error codes
Reference for every structured error code the Gofasta CLI emits — the stable machine-readable identifiers in `--json` output, grouped by...
gofasta debug
Inspect a running app's requests, SQL, traces, and logs from the terminal.
gofasta inspect
Structured view of a resource's model, DTOs, service methods, and routes.
Error codes
Every structured code the CLI emits, including INTERACTIVE_ONLY.