template-cli

name	template-cli
description	Run and talk to the template app from the terminal — serve the api/mcp/auth/dashboard surfaces, call any API endpoint through the generated SDK, and manage login. Use when asked to start a local server, hit an endpoint, or check the current user.

template-cli

bun run cli <command> from the repo root, or template-cli <command> once the bin is linked.

Serve

template-cli serve api         # Hono API on API_PORT (default 3000)
template-cli serve mcp         # MCP server on MCP_PORT (default 3001), at /mcp
template-cli serve auth        # OpenAuth issuer on PORT (default 3002)
template-cli serve dashboard   # SvelteKit prod build on PORT (auto-builds if missing)

All except dashboard need a reachable DATABASE_URL. For a local DB run bun dev first.

Call the API

The method list is reflected off the generated @template/sdk, so it always matches the current endpoints. Discover before guessing:

template-cli api                              # list callable methods
template-cli api getTodo                      # GET /todo
template-cli api postTodo --title "Ship it"   # POST /todo
template-cli api postTodo '{"title":"Ship"}'  # same, as a JSON blob
template-cli api getTodoById --id tod_123

Flags become call params (--key value, --key=value, or bare --flag for true). Values coerce to number/boolean when they look like one. --token and --url are consumed by the client and never sent as params.

Results print as JSON on stdout; errors print as JSON on stderr and exit non-zero — so pipe into jq and check the exit code.

Auth

template-cli login     # opens the browser, PKCE, saves tokens
template-cli whoami    # current user
template-cli logout

login writes ~/.config/template/config.json (respects XDG_CONFIG_HOME) and opens a loopback server on port 3006 for the callback; it times out after 2 minutes. It needs a browser — in a headless session, set TEMPLATE_TOKEN to an sk- API key instead.

Token: --token › TEMPLATE_TOKEN › saved key › saved OAuth access (auto-refreshed). Base URL: --url › API_URL › saved config › http://localhost:3000. Issuer: --issuer › AUTH_URL › saved config › http://localhost:3002.