Nova AI Onboarding Guide¶

Get /novaai working in 3 commands - no repo clone needed!

Quick Start¶

# 1. Add the Nova AI marketplace
/plugin marketplace add Jaureguy760/nova_ai

# 2. Install the plugin
/plugin install nova-ai

# 3. Download the knowledge base (5.4GB, one-time)
/init

Done! Now /novaai works in any project.

Prerequisites¶

Before starting, ensure you have:

1. Claude Code Installed¶

# Option A: npm (requires Node.js 18+)
npm install -g @anthropic-ai/claude-code

# Option B: Native binary (recommended)
# macOS/Linux:
curl -fsSL https://claude.ai/install.sh | sh

2. GitHub CLI Authenticated¶

# Install gh if needed
brew install gh  # macOS
# or: sudo apt install gh  # Ubuntu/Debian

# Authenticate
gh auth login
# → Select: GitHub.com
# → Select: HTTPS
# → Authenticate with browser

3. Repository Access¶

You need collaborator access to Jaureguy760/nova_ai. Ask the repo owner to add you: - Go to: https://github.com/Jaureguy760/nova_ai/settings/access - Click "Add people" - Enter your GitHub username

Installation Options¶

Full Suite (Recommended)¶

/plugin install nova-ai

Includes: - 24 commands (/novaai, /background, /fix-pr, /paper, /research, etc.) - 15 agents (orchestrator, implementer, code-reviewer, validator, architect, linter, AWS agents, research agents) - 4 MCP servers (knowledge base, GitHub, memory, blarify) - 5.4GB knowledge base

Core Only (Lightweight)¶

/plugin install nova-ai-core

Includes: - 6 essential commands (/novaai, /background, /fix-pr, /clean, /context-prime, /doctor) - 5 core agents (orchestrator, implementer, code-reviewer, validator, linter) - No MCP servers or KB (uses Claude's general knowledge)

Research Suite¶

/plugin install nova-ai-research

Includes: - 5 commands (/paper, /research, /ml-experiment, /visualize, /voice) - 2 agents (research-plotter, slides-designer)

AWS Suite¶

/plugin install nova-ai-aws

Includes: - 2 commands (/novaai-aws, /novaai-devbox) - 5 agents (aws-deployment-planner, infrastructure-generator, cost-optimizer, devbox-agent, aws-devops-bootstrapper)

Verification¶

After installation, verify everything works:

# Check plugin is installed
/plugin list
# Should show: nova-ai (2.15.0)

# Run diagnostics
/doctor
# Should show all green checks

# Test a simple task
/novaai say hello world

What Gets Installed¶

Location	Contents
`~/.claude/commands/`	24 slash commands
`~/.claude/agents/`	15 agent definitions
`~/.claude/skills/`	47 skills
`~/.claude/settings.json`	MCP server configs
`~/.local/share/nova-ai/kb/`	5.4GB knowledge base

Usage Examples¶

Basic Orchestration¶

/novaai implement user authentication with JWT

This will: 1. Ask clarifying questions 2. Search the knowledge base for patterns 3. Present an implementation plan 4. Execute with quality gates (implement → review → test)

Background Tasks¶

/novaai implement complex feature --background

Runs in a tmux session so you can continue working.

PR Workflows¶

/fix-pr 123

Reviews PR #123, implements fixes, runs tests.

Research Workflows¶

/paper search "transformer attention mechanisms"
/visualize plot scatter data.csv

Troubleshooting¶

"Repository not found"¶

You need collaborator access. Ask the repo owner to add you at: https://github.com/Jaureguy760/nova_ai/settings/access

"Authentication failed"¶

Re-authenticate with GitHub:

gh auth login
gh auth status  # Verify

"Command not found"¶

Reinstall the plugin:

/plugin uninstall nova-ai
/plugin install nova-ai

"KB download failed"¶

Check your internet connection and retry:

/init

Or download manually:

python -m src.orchestrator.tools.kb_downloader download

"MCP servers not working"¶

Check Python dependencies:

pip install anthropic faiss-cpu sentence-transformers

Updating¶

# Check for updates
/plugin update nova-ai

# Or reinstall
/plugin uninstall nova-ai
/plugin install nova-ai

Uninstalling¶

# Remove plugin
/plugin uninstall nova-ai

# Remove knowledge base (optional, frees 5.4GB)
rm -rf ~/.local/share/nova-ai/

Support¶

Issues: https://github.com/Jaureguy760/nova_ai/issues
Discussions: https://github.com/Jaureguy760/nova_ai/discussions
Docs: https://918014da.nova-ai-2ea.pages.dev/

Welcome to Nova AI! 🚀