Skip to main content
The naive CLI is built for agentic use — every command returns structured JSON with result data, contextual next steps, and guidance for autonomous operation. It follows the same patterns as tools like Meow and Lindy.

​
Installation

npm install -g @usenaive-sdk/cli

​
Active user

Naive is multi-tenant. Every primitive command acts on a tenant user. By default that’s the API key’s default user, so solo usage needs no setup.
  • naive use <user_id> — set the active user for subsequent commands
  • naive use --clear — reset to the default user
  • --user <id> — override the active user for a single command
naive use alice_user_id
naive cards list                  # acts on alice
naive cards list --user bob_id    # one-off override
See users and account-kits for managing tenants.

​
Agent-Native Output

Every command returns a structured JSON response: 
{
  "success": true,
  "action": "email.send",
  "result": { "message_id": "msg-uuid-123" },
  "next_steps": [
    { "command": "naive email inbox", "description": "Monitor inbox for replies" },
    { "command": "naive email read msg-uuid-123", "description": "View sent message details" }
  ],
  "hints": [
    "Email sent successfully",
    "Cost: 1 credit"
  ],
  "related_commands": ["naive email inbox", "naive email read"]
}
This makes it trivial for AI agents to:
  • Parse results programmatically
  • Determine what to do next
  • Chain operations autonomously
  • Understand error recovery paths

​
Configuration

Config is stored at ~/.naive/config.json: 
{
  "api_key": "nv_sk_live_...",
  "base_url": "https://api.usenaive.ai",
  "agent_id": "uuid",
  "company_id": "uuid",
  "company_name": "Acme Corp"
}
The config is automatically populated when you register or login: 
naive register --name "My Agent" --email me@example.com --password mypassword
# or
naive login --email me@example.com --password mypassword

​
Environment Variables

VariableDescription
NAIVE_API_KEYOverride API key (for CI/headless use)
NAIVE_BASE_URLOverride API URL (default: https://api.usenaive.ai)

​
Command Groups

​
Orchestration

GroupCommandsDescription
CEOceo run, ceo message, ceo status, ceo sessions, ceo stream, ceo team-approveCEO agent — run prompts, approve teams, stream output
Taskstasks list, tasks create, tasks show, tasks complete, tasks block, tasks unblock, tasks comment, tasks dispatch, tasks statsKanban task management
Objectivesobjectives list, objectives create, objectives show, objectives update, objectives pause, objectives abandonStrategic goals
Employeesemployees list, employees hire, employees fire, employees configureAI workforce management
Croncron create, cron list, cron trigger, cron pause, cron removeScheduled recurring jobs
Memorymemory add, memory list, memory removePersistent agent context

​
Primitives

GroupCommandsDescription
Authregister, login, link, verify, whoami, companies, keysAccount creation, authentication, company management
Identityidentity, identity emails, identity resourcesView provisioned resources
Appsapps list, apps create, apps templates, apps show, apps deploy [--dir], apps publish, apps deployments, apps retry, apps secrets, apps domains, apps db, apps vercel, apps supabase, apps deleteVercel-hosted web apps with optional Supabase backend — build locally from public templates and deploy directly, or via engineer agents; incl. scoped provider API proxies
Domainsdomains, domains connect, domains setup-records (alias: dns-records), domains verify, domains search, domains purchase, domains zone-records, domains set-record, domains delete-recordDomain management, search + purchase, agent DNS record editing
Billingbilling plans, billing subscribe, billing upgrade, billing status, billing portal, billing packs, billing topupPlans, subscriptions, credit top-ups
Emailemail inboxes, email create, email delete, email send, email inbox, email readCreate inboxes, send/receive email
Searchsearch, search url, search researchWeb search, URL extraction, deep research
LLMllm chat, llm modelsOpenRouter-backed chat completions across 300+ models
Imagesimages generate, images stock, images status, images modelsAI image generation and stock photos
Videovideo generate, video status, video modelsAI video generation
Socialsocial status, social activate, social connect, social accounts, social post, social posts, social publish, social analyticsSocial media management via Naive’s social infrastructure
Tradingtrading connect, trading connections, trading account, trading assets, trading positions, trading order, trading orders, trading close, trading cancel, trading quoteLink a brokerage account (OAuth) and trade stocks, options & crypto
Verificationverification start, verification list, verification status, verification complete, verification resendNaive-native identity verification (KYC)
Formationformation naics-codes, formation submit, formation list, formation status, formation documents, formation downloadNaive-native LLC formation
Travelbusiness google hotel-searches, business google hotel-info, business tripadvisor searchTravel discovery and hotel intelligence
Reviewsbusiness google my-business-info, business google reviews, business google qna, business trustpilot, business tripadvisor reviews, business social, business tasks-ready, business task-getReputation, review aggregation, and engagement metrics
Jobsjobs, jobs get, jobs cancelMonitor async operations
Statusstatus, usageAccount status and credit history

​
Getting Started

# 1. Create account
naive register --name "Research Agent" --email agent@company.com --password s3cur3pw

# 2. Verify connectivity
naive status

# 3. Discover resources
naive identity emails

# 4. Start using primitives
naive search "latest AI developments"
naive email send --from-inbox <uuid> --to team@company.com --subject "Report" --body "..."
naive images generate "product mockup" --model fal-ai/flux/schnell --wait

​
Error Handling

Errors also return structured JSON with recovery guidance: 
{
  "success": false,
  "action": "email.send",
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this operation",
    "hint": "Add credits at https://usenaive.ai/billing"
  },
  "recovery_steps": [
    { "command": "naive usage", "description": "Check credit usage history" },
    { "command": "naive status", "description": "View current balance and tier" }
  ]
}

​
Detailed Help

Every command has comprehensive built-in help with examples: 
naive --help                    # Full CLI overview
naive email --help              # Email command group
naive email send --help         # Specific command with examples
naive video generate --help     # Parameters, models, costs