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.

​
Register (New Account)

Creates a new account with email and password, provisions a company workspace and API agent with 100 free credits. 
naive register --name "Alex" --email alex@company.com --password mypassword123
naive register --name "Build Agent" --email agent@acme.co --password s3cur3pw --company "Acme Corp"

​
Options

FlagRequiredDescription
--name <name>YesYour name or agent identity name
--email <email>YesEmail address (must be unique)
--password <password>YesAccount password (min 8 characters)
--company <name>NoCompany name (defaults to “<name>’s Company”)

​
Output

{
  "success": true,
  "action": "register",
  "result": {
    "agent_id": "uuid",
    "company_id": "uuid",
    "company_name": "Acme Corp",
    "credentials_saved": "~/.naive/config.json",
    "initial_credits": 100
  },
  "next_steps": [
    { "command": "naive status", "description": "Verify account status and available credits" },
    { "command": "naive identity", "description": "View provisioned resources (email inboxes, etc.)" },
    { "command": "naive email inboxes", "description": "List email addresses available for sending" }
  ],
  "hints": [
    "Your API key is saved locally — all future commands authenticate automatically",
    "You start with 100 free credits. Use 'naive usage' to track spending."
  ]
}

​
Login (Existing Account)

Authenticates with an existing email + password and issues a new API key. 
naive login --email alex@company.com --password mypassword123

​
Options

FlagRequiredDescription
--email <email>YesAccount email address
--password <password>YesAccount password

​
Output

{
  "success": true,
  "action": "login",
  "result": {
    "agent_id": "uuid",
    "company_id": "uuid",
    "company_name": "Acme Corp",
    "credentials_saved": "~/.naive/config.json",
    "companies": [
      { "id": "uuid-1", "name": "Acme Corp" },
      { "id": "uuid-2", "name": "Side Project" }
    ]
  },
  "next_steps": [
    { "command": "naive status", "description": "Check current credits and resources" },
    { "command": "naive companies select <id>", "description": "Switch to a different company" }
  ]
}

​
Notes

  • Uses the same credentials as the Naive dashboard (usenaive.ai)
  • If you have multiple companies, the first is selected by default
  • Each login creates a new API key (old keys remain valid)
Links to an existing account via email verification code. 
# Step 1: Request verification code
naive link --email existing@example.com

# Step 2: Complete with code from email
naive verify --email existing@example.com --code 482910

​
When to Use

  • You created your account through a social provider (Google, GitHub)
  • You prefer passwordless authentication
  • You want to link a second machine/agent to an existing account
{
  "success": true,
  "action": "link",
  "result": { "status": "verification_sent", "email": "existing@example.com" },
  "next_steps": [
    { "command": "naive verify --email existing@example.com --code <6-digit-code>", "description": "Complete verification" }
  ],
  "hints": ["A 6-digit code has been sent to your email", "The code expires in 10 minutes"]
}

​
Companies

List all companies accessible to your account: 
naive companies

​
Output

{
  "success": true,
  "action": "companies.list",
  "result": {
    "companies": [
      { "id": "uuid-1", "name": "Acme Corp", "credits": 1500, "tier": "pro" },
      { "id": "uuid-2", "name": "Side Project", "credits": 100, "tier": "free" }
    ]
  },
  "next_steps": [
    { "command": "naive companies select <company_id>", "description": "Switch to a different company context" }
  ]
}

​
Select Company

Switch the active company context (issues a new API key): 
naive companies select 550e8400-e29b-41d4-a716-446655440000

​
Keys

Manage API keys for the current agent/company: 
# List all keys
naive keys list

# Create a new key
naive keys create --name "Production Server"

# Revoke a key (permanent)
naive keys revoke <key-id>

​
Who Am I

naive whoami

{
  "success": true,
  "action": "whoami",
  "result": {
    "agent_id": "uuid",
    "agent_name": "Research Bot",
    "company_id": "uuid",
    "company_name": "Acme Corp"
  },
  "next_steps": [
    { "command": "naive status", "description": "See full status including credits and resources" },
    { "command": "naive companies", "description": "List all companies you have access to" }
  ]
}