Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
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

GroupCommandsDescription
Authregister, login, link, verify, whoami, companies, keysAccount creation, authentication, company management
Identityidentity, identity emails, identity resourcesView provisioned resources
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
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 bundle.social
Verificationverification start, verification list, verification status, verification complete, verification resendIdentity verification (KYC) via Footprint
Formationformation naics-codes, formation submit, formation list, formation status, formation documents, formation downloadCompany formation (LLC) via Doola
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