heimdall-cli

CLI for scaffolding and integrating Heimdall auth/dashboard.

Run without install (npx)

npx combine-heimdall-cli@latest init

Publish to npm

cd heimdall-cli
npm login
npm test
npm publish --access public

Commands

• heimdall create <project-name> [--template <path>]
• heimdall init [--api-base <url>] [--login-url <url>] [--dashboard-url <url>] [--template-url <git-url>] [--service-token <token>] [--no-open-login] [--no-install]
• heimdall add-auth [--path <project-path>]
• heimdall register-project --slug <slug> --name <name> [--api-base <url>] [--service-token <token>]
• heimdall link-dashboard --project-id <id> [--path <project-path>] [--ai-key <key>]

One-command setup (init)

• Runs a menu-driven TUI wizard (arrow-key selects + confirms) with clear section headers and explanations.
• Shows defaults up front (API/login/dashboard/template/install) and lets you accept all defaults quickly.
• Prompts for project name only; slug is generated automatically from that name (and resolves conflicts automatically).
• Checks project-name/slug availability after login and asks whether to rename or auto-suffix if it is already taken.
• Opens the login page in your browser with a local callback and captures your authenticated session.
• Registers the project in Heimdall (/v1/projects) using your logged-in user session.
• Scaffolds app code from local template or latest template from a git URL.
• Writes .env.local with project linkage and optionally installs dependencies.

create output highlights

• Prewired /admin starter shell (sidebar + mobile drawer)
• Default admin routes: /admin, /admin/ai, /admin/access, /admin/settings