Why ship a CLI at all when the API is the canonical surface?

Because terminal, CI, and shell workflows are how engineering teams actually work. The CLI wraps the REST API with sensible defaults, ergonomic command syntax, and config persistence, so day-to-day operations do not require hand-writing curl commands. Everything the CLI does is also available via the API.

Both. pip install sentie ships the Python distribution and npm install -g sentie ships the Node distribution. Both wrap the same REST API and provide identical command surfaces. Choose whichever fits your team's runtime.

Where does the CLI store config?

By default at ~/.sentie/config.json. Override with the --config flag or the SENTIE_CONFIG environment variable. The config holds your token, default tenant, and any per-command preferences.

Can I use the CLI in CI?

Yes. Set SENTIE_TOKEN as a CI secret and run sentie commands non-interactively. All commands accept --json to emit machine-readable output for scripting.

Does the CLI work offline?

The CLI makes HTTPS calls to api.sentie.io, so it needs network. Local commands like sentie configure run without network, but anything that creates, updates, or reads agents talks to the API.

// developers / cli

sentie CLI.
Custom AI agents from the terminal.

One command-line tool that wraps the Sentie REST API. Install via pip or npm. Drive assessments, agents, capabilities, and integrations without leaving your shell. Built for scripting, CI, and the day-to-day operator who lives in the terminal.

// install

Pip or npm. Pick one.

Python

pip install sentie

Node

npm install -g sentie

Both distributions wrap the same REST API and expose identical commands. Verify with sentie --version.

// first run

Sign in, configure, start an agent.

# 1. Authenticate (opens a browser to your dashboard)
sentie auth login

# 2. Start a free custom AI agent assessment
sentie assess \
  --industry hvac \
  --use-case quote-follow-up \
  --use-case dispatch-triage

# 3. Once your Success Manager scopes it, list configured agents
sentie agents list

Config persists to ~/.sentie/config.json. Override with --config or SENTIE_CONFIG.

// commands

Full command surface.

sentie auth login

Interactive token setup. Opens a browser to your Sentie dashboard, generates a token, and stores it at ~/.sentie/config.json.

sentie assess --industry hvac --use-case quote-follow-up

Start a free custom AI agent assessment from the terminal. Submits the equivalent of a POST /v1/assessments and returns an assessment id.

sentie assess status <id>

Poll the state of an in-progress assessment. Shows what the Success Manager has scoped so far.

sentie agents list

List all custom AI agents configured on the current tenant. Add --json for machine output.

sentie agents create --capability sales-followup --integration hubspot

Configure a new specialized agent. Wraps POST /v1/agents with structured flag parsing.

sentie agents show <id>

Read configuration, capabilities, integration bindings, and the action log for a single agent.

sentie capabilities list

Print the catalog of capability categories your custom AI agents can be configured with.

sentie integrations list

Print the 248+ supported tool integrations Sentie can connect a custom AI agent to.

sentie pricing

Print current Sentie pricing tiers and what each tier includes. Useful inside automation scripts that need to evaluate Sentie programmatically.

sentie configure --tenant <slug>

Switch the active tenant for the current shell. Useful when you operate Sentie across multiple businesses.

// ci usage

Use it in your pipelines.

# .github/workflows/sentie-sync.yml
- name: Sync Sentie agents
  env:
    SENTIE_TOKEN: ${{ secrets.SENTIE_TOKEN }}
  run: |
    sentie agents list --json > agents.json
    sentie integrations list --json > integrations.json

Every command accepts --json for scripting. Non-zero exit codes on failure so the runner can decide whether to keep going.

// related

REST API

The canonical surface

OpenAPI spec

sentie.io/openapi.json

// cli faq

CLI questions, answered.

Don't see your questions answered? Book a call with a human Success Manager.

Still have questions?

Speak to a human Success Manager.

Book a call

Get a token in your Sentie dashboard.

Free assessment unlocks CLI access. No credit card.

Start free assessment Book a call

sentie CLI.Custom AI agents from the terminal.