Senso CLI

The Senso CLI is what your AI agent uses behind the scenes to interact with your knowledge base. You don't need to memorize these commands — once you install agent skills, your agent runs them automatically when you ask it to ingest, query, or generate.

This page is a reference for what's available.

How it works: Raw sources go in, get compiled into a verified knowledge base, then your agent queries and generates against it. The CLI handles the full pipeline.

Install the CLI

Requires Node.js 18+. Works on Linux, macOS, and Windows.

npm install -g @senso-ai/cli

Or run it once without installing:

npx @senso-ai/cli --help

Verify it's working:

senso --version

Log in

The simplest way to authenticate:

senso login

Paste your API key when prompted. Your credentials are stored securely in your OS config directory.

For automated setups (CI, scripts), set the environment variable instead:

export SENSO_API_KEY=tgr_live_abc123...

Check your auth status:

senso whoami

How your agent uses these commands

When you ask your agent something like "Generate a FAQ from our product docs", it runs commands like these behind the scenes:

senso generate sample --prompt-id <id> --content-type-id <id> --output json --quiet

The --output json flag gives structured output the agent can read, and --quiet hides decorative banners. You don't need to worry about these flags — skills teach your agent to use them automatically.

Commands reference

Ingest raw sources

# Ingest one or more files (up to 10 at once)
senso ingest upload policy.pdf handbook.docx --output json --quiet

# Ingest into a specific folder
senso kb upload report.pdf --folder-id <folder-id> --output json --quiet

# Replace a source on an existing document (uses KB node ID)
senso ingest reprocess <node-id> updated-policy.pdf --output json --quiet

Supported formats: PDF, TXT, CSV, DOC, DOCX, XLS, XLSX, PPT, PPTX, HTML, MD, JSON, XML.

Generate verified content

# Generate a single piece of content from your compiled knowledge base
senso generate sample --prompt-id <id> --content-type-id <id> --output json --quiet

# Trigger a full generation run
senso generate run --output json --quiet

# Check generation settings
senso generate settings --output json --quiet

Query the knowledge base

# Get a grounded AI answer with source citations (most common)
senso search "What is our refund policy?" --output json --quiet

# Get raw source chunks without an AI answer
senso search context "mortgage rates" --output json --quiet

# Get just the document names and IDs
senso search content "mortgage rates" --output json --quiet

Browse and organize your knowledge base

# List your ingested sources and folders
senso kb my-files --output json --quiet

# Search for a source by name
senso kb find --query "refund" --output json --quiet

# Create a folder
senso kb create-folder --name "Policies" --output json --quiet

# Get details about a specific document
senso content get <content-id> --output json --quiet

# List all content
senso content list --output json --quiet

Set up your brand

# View your brand kit
senso brand-kit get --output json --quiet

# Set your brand kit (full replacement)
senso brand-kit set --data '{
  "guidelines": {
    "brand_name": "Acme Corp",
    "voice_and_tone": "Professional yet approachable",
    "author_persona": "Senior product expert"
  }
}' --output json --quiet

# Update one field without replacing everything
senso brand-kit patch --data '{
  "guidelines": { "voice_and_tone": "Casual and direct" }
}' --output json --quiet

Manage content types

# List content type templates
senso content-types list --output json --quiet

# Create a new content type
senso content-types create --data '{
  "name": "Product FAQ",
  "config": {
    "template": "## Question\\n\\n## Answer",
    "writing_rules": ["Keep answers under 100 words"]
  }
}' --output json --quiet

Publish and review

# See content waiting for review
senso content verification --output json --quiet

# Publish verified content
senso engine publish --data '{
  "geo_question_id": "<prompt-id>",
  "raw_markdown": "# Your content here...",
  "seo_title": "Page Title",
  "summary": "Brief summary"
}' --output json --quiet

# Save as draft
senso engine draft --data '{
  "geo_question_id": "<prompt-id>",
  "raw_markdown": "# Draft content...",
  "seo_title": "Page Title",
  "summary": "Brief summary"
}' --output json --quiet

Account and organization

# Check your credit balance
senso credits balance --output json --quiet

# View organization details
senso org get --output json --quiet

# List API keys
senso api-keys list --output json --quiet

Install and manage skills

# Install all Senso agent skills
senso skills install --all

# Install for a specific agent
senso skills install --all --agent claude

# Install specific skills by name
senso skills install search ingest content-gen

# List installed skills
senso skills list

# See available skills
senso skills list-available

# Remove a skill
senso skills remove search

All command groups

Command	What it does
senso ingest	Ingest raw sources into your knowledge base
senso search	Query your compiled knowledge base — grounded answers, raw chunks, or document IDs
senso generate	Generate verified content from your ingested sources
senso content	List, view, delete, and manage compiled content
senso engine	Publish verified content or save drafts
senso kb	Browse and organize your knowledge base — folders, sources, text content
senso brand-kit	View and configure your brand voice and writing rules
senso content-types	Manage content type templates
senso prompts	Manage the questions that drive content generation
senso skills	Install and manage agent skills
senso questions	Manage GEO questions
senso permissions	View available permission settings
senso credits	Check your credit balance
senso org	View and update organization settings
senso users	Manage organization users
senso members	List organization members
senso api-keys	Create, view, and manage API keys
senso run-config	Configure AI models and generation schedules

Run senso --help or senso --help for detailed options.

Global options

Every command accepts these flags:

Flag	What it does
--api-key	Use a specific API key for this command
--output	json, table, or plain (default: plain)
--quiet	Hide banners and decorative output
--no-update-check	Skip the automatic version check
-h, --help	Show help

Keeping the CLI up to date

The CLI checks for updates automatically. To update manually:

senso update

Next steps

Agent Skills — Install skills so your agent runs these commands automatically

Knowledge Base — Organize your ingested sources into folders

Quickstart — Ingest a raw source and start querying in 5 minutes

API Reference — Browse all endpoints the CLI wraps