Getting Started

1. Install Go

Download and install Go from go.dev/dl (1.21 or later required).

Verify it works:

go version
# go version go1.21.x ...

Windows users

After installing Go, restart your terminal so go is available in PATH.

2. Install Wick CLI

go install github.com/yogasw/wick@v0.3.0

Verify:

wick version

3. Init a project

wick init my-app

This scaffolds my-app/, runs go mod tidy, and downloads Tailwind + templ automatically.

my-app/
├── main.go          # register tools and jobs here
├── AGENTS.md         # AI agent instructions (auto-included)
├── wick.yml         # task runner config
├── tools/
│   ├── convert-text/   # example tool
│   └── external/       # external link cards
├── jobs/
│   └── auto-get-data/  # example job
└── tags/
    └── defaults.go     # shared tag catalog

Skip auto-setup

Use --skip-setup if you want to run setup manually later:

wick init my-app --skip-setup
cd my-app && go mod tidy && go run . setup

4. Configure environment (optional)

Wick boots without any configuration — SQLite is used by default, no database setup needed.

To customize, copy the example file:

cp .env.example .env

All variables have working defaults. The only ones you may want to change before first boot:

Variable	Default	Notes
DATABASE_URL	(blank = SQLite)	Set to a Postgres URL to use PostgreSQL
APP_ADMIN_EMAILS	admin@example.com	Your email, gets admin on first login
APP_ADMIN_PASSWORD	admin	Change after first login

Everything else (app name, URL, SSO, OAuth) is editable from /admin/configs after the app starts.

5. Start dev server

cd my-app
wick dev

This generates templ, rebuilds CSS, and starts the server at http://localhost:8080.

6. Let Claude build your tools

Open the project in Claude Code. Every project includes AGENTS.md and Claude skills — Claude already knows the conventions.

Just tell Claude what you need:

add a tool called "base64" that encodes and decodes text

See AI Quickstart for more sample prompts.

Common commands

The ones you'll reach for day-to-day:

Command	What it does
wick dev	Generate templ + CSS, start server at http://localhost:8080
wick build	Generate + minify CSS, compile binary
wick test	Run go test ./... with coverage
wick skill sync	Refresh bundled AI skills after upgrading wick

Full list — built-in CLI commands (init, run, skill, version) and task shortcuts from wick.yml (dev, setup, build, test, tidy, generate) — see the CLI reference.