Novaursa CLI

Think sharper, ship smarter.

Install, manage, and orchestrate Novaursa kits — specialised AI toolkits that inject domain expertise into Claude Code for engineering, marketing, product, business, and Vietnamese divination.

Install

npm install -g @novaursa/cli

Works with npm, pnpm, yarn, and bun.

Quick start

nova init build      # Install the engineering kit in the current project

That's it. nova detects your setup, downloads the kit, wires up Claude Code, and gets out of your way.

The kits

Each kit is a self-contained AI team for a domain. Install one, several, or all — they work independently.

| Kit | Command | Purpose | | --------- | -------------------- | ------------------------------------------------------------------------------- | | Build | nova init build | AI-powered development — planning, testing, review, deployment | | Mkt | nova init mkt | Marketing automation — campaigns, SEO, email, social | | Biz | nova init biz | Business strategy — SaaS metrics, investor updates, OKRs | | PM | nova init pm | Product management — PRDs, roadmaps, sprint planning | | Fate | nova init fate | Vietnamese divination — Tử Vi & Mai Hoa | | Forge | nova init forge | Quality engine — keeps other kits sharp |

Browse skills, commands, and agents after install with nova skills, nova commands, nova agents.

Common workflows

nova init build -y                    # Non-interactive install, latest stable
nova init -g                          # Install globally (~/.claude)
nova init --kit engineer,mkt          # Install multiple kits at once
nova init --beta                      # Use beta versions

nova doctor                           # Diagnose your setup
nova config                           # Open the web dashboard
nova update                           # Update the CLI
nova migrate                          # Idempotent migration between kit versions

Full help:

nova --help
nova <command> --help

The dashboard

Rich web UI for configuration, project management, and skill browsing.

nova config

Opens http://localhost:3456 (auto-finds a free port 3456-3460). Runs locally only — your data never leaves your machine.

Need remote access? nova config --host 0.0.0.0 --no-open exposes it on your network (same-origin browser check still applies).

Prerequisites

• Node.js 20+ (the CLI is Node-compatible; Bun is optional, only needed for CLI development)
• GitHub CLI authenticated (gh auth login) — used to download kit releases
• Access to the kit repos under github.com/Novaursa. Kits are private — visit novaursa.tech for access.

How it works

1. You run nova init <kit> — the CLI queries GitHub Releases for the latest kit version
2. Downloads the release archive — extracts it to your project's .claude/ directory
3. Merges with your customisations — SHA-256 checksums detect user edits and preserve them on updates
4. Claude Code picks it up automatically — skills, commands, agents, and hooks become available in your next session

No lock-in. All files are plain markdown + JSON. Uninstall cleanly with nova uninstall.

Features

• Zero-friction install — one command, no config files to write
• Multi-kit support — stack any combination of kits in one project
• Smart merging — your customisations survive every update
• Offline mode — install from local archives or directories (--archive, --kit-path)
• Cross-platform — macOS, Linux, Windows (native paths on each)
• Idempotent migration — nova migrate reconciles version changes with RECONCILE → EXECUTE → REPORT pipeline
• Health checks — nova doctor diagnoses setup, hooks, Python envs, and more

Privacy

Novaursa collects telemetry locally only — nothing is sent to external servers. All data stays in ~/.novaursa/ on your machine.

Opt out entirely with NOVAURSA_TELEMETRY=0. See PRIVACY.md for details.

Links

• Website — novaursa.tech
• Monorepo — github.com/Novaursa/novaursa-toolkit
• Philosophy — PHILOSOPHY.md
• Constitution — CONSTITUTION.md
• Issues — github.com/Novaursa/novaursa-cli/issues

Novaursa — Founded by Duc Thach (Vincent). Licensed under MIT.