cli — Wagoe Docs

Standalone CLI tool for bootstrapping new Wagoe projects and adding optional modules. Installed via bbin — does not require the monorepo. Generated projects are fully self-contained.

Note	Not published to Clojars. Installed via bbin from the GitHub repository.

Install

curl -fsSL https://get.wagoe.org | bash

The installer handles all prerequisites: JVM, Clojure CLI, Babashka, bbin, and the wagoe command itself. Supports macOS, Debian/Ubuntu, Arch Linux, and WSL2.

Fallback if get.wagoe.org is unavailable:

curl -fsSL https://raw.githubusercontent.com/wagoebv/wagoe/main/scripts/install.sh | bash

Commands

Create a new project

wagoe new my-app          # Scaffold a new project
wagoe new my-app --force  # Overwrite existing directory

Generates a complete project with four core modules pre-wired: core, observability, platform, and user. The project is immediately runnable after clojure -M:migrate up.

Add a module

wagoe add payments          # PSP abstraction (Stripe / Mollie / Mock)
wagoe add cache             # Redis / in-memory caching
wagoe add search            # Full-text search (Meilisearch)
wagoe add jobs              # Background job processing

Wires the module into deps.edn, system.clj, and migration files.

List available modules

wagoe list modules          # Human-readable table
wagoe list modules --json   # Machine-readable JSON

Show version

wagoe version

Generated project structure

my-app/
├── deps.edn          # Clojure deps with :migrate, :repl, :test aliases
├── bb.edn            # Babashka tasks (scaffold, check, doctor, deploy, ...)
├── dev-config.edn    # Development environment config
├── test-config.edn   # Test environment config
├── src/
│   └── my_app/
│       └── system.clj    # Component system wiring
└── AGENTS.md         # AI agent context file

Manual bbin install (advanced)

If you prefer to manage your own bbin installation:

bbin install https://github.com/wagoebv/wagoe \
  --tag v1.0.1-alpha-15 \
  --git/root libs/wagoe-cli \
  --main-opts '["-m" "wagoe.cli.main"]' \
  --as wagoe

AI agent tooling

The installer also installs clj-nrepl-eval and clj-paren-repair from clojure-mcp-light for REPL-over-MCP workflows:

clj-nrepl-eval --discover-ports   # Connect AI agent to running REPL