Skip to main content

SenseLab CLI for managing AI agents

Project description

SenseLab CLI

SenseLab CLI helps you manage AI agents and run specialist workflows from your terminal.

With this CLI you can:

  • authenticate with your SenseLab account
  • list your projects, agents, and functions
  • chat with orchestrator or specific agents
  • execute agent functions/workflows
  • discover and connect integrations
  • apply agent configuration from YAML
  • manage Rego policies for CI/CD enforcement

Install

Recommended (pipx)

pipx install senselab-cli

pip

pip install senselab-cli

Quick start

  1. Login:
sense-cli login --token "<YOUR_JWT_TOKEN>"
  1. Check configuration and auth:
sense-cli config list -o json
  1. List your project/agents/functions:
sense-cli projects
sense-cli agent list
sense-cli agent <agent_name_or_id> function --list
  1. Chat with an agent:
sense-cli agent <agent_name_or_id> --chat "Summarize current production incidents"

or run a specific function on an agent:

sense-cli agent <agent_name_or_id> --run <function_name_or_id>

Main commands

  • sense-cli login - authenticate and save token
  • sense-cli logout - clear local auth/session data
  • sense-cli config list - show current CLI config + auth status
  • sense-cli projects - list available project IDs
  • sense-cli agent list - list available agents
  • sense-cli agent <agent> function --list - list functions/workflows for a specific agent
  • sense-cli agent <agent> function - same as above (default list behavior)
  • sense-cli agent <agent> --chat "<prompt>" - chat with a specific agent
  • sense-cli agent <agent> --run <function> - execute a function/workflow on a specific agent
  • sense-cli connectors list - list available connector types
  • sense-cli connectors describe <connector> - show connector setup requirements
  • sense-cli connectors add <type> - open connector auth/config flow
  • sense-cli apply -f agent.yaml - declaratively create/update agent setup
  • sense-cli policy test --repo <repo> --branch <branch> --commit <sha> - parse local .rego files without uploading
  • sense-cli policy sync --repo <repo> --branch <branch> --commit <sha> - sync local .rego files to backend
  • sense-cli policy list - list project policies
  • sense-cli telemetry on|off - enable/disable anonymous CLI telemetry
  • sense-cli completion auto --install - auto-install shell completion

Configuration

Environment variables:

  • SENSELAB_API_URL - override API base URL
  • SENSELAB_TOKEN - override auth token
  • SENSELAB_CONFIG_PATH - custom config file path
  • BACKEND_URL - backend base URL for policy sync (basic-auth parity)
  • TOKEN_NAME - CI token name for policy sync/auto-assignment
  • TOKEN_SECRET - CI token secret for policy sync/auto-assignment

Default config path:

  • ~/.sense-cli/config.json

Help

sense-cli --help
sense-cli <command> --help

CI/CD example (policy sync)

export BACKEND_URL="https://dev-backend-api.app.raia.live"
export TOKEN_NAME="<ci_token_name>"
export TOKEN_SECRET="<ci_token_secret>"

sense-cli policy test --repo "$GITHUB_SERVER_URL/$GITHUB_REPOSITORY" --branch "$GITHUB_REF_NAME" --commit "$GITHUB_SHA" --path ./raia/policies -o table
sense-cli policy sync --repo "$GITHUB_SERVER_URL/$GITHUB_REPOSITORY" --branch "$GITHUB_REF_NAME" --commit "$GITHUB_SHA" --path ./raia/policies --auto-assignment -o json
sense-cli policy list -o table

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

senselab_cli-0.1.29.tar.gz (51.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

senselab_cli-0.1.29-py3-none-any.whl (45.5 kB view details)

Uploaded Python 3

File details

Details for the file senselab_cli-0.1.29.tar.gz.

File metadata

  • Download URL: senselab_cli-0.1.29.tar.gz
  • Upload date:
  • Size: 51.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for senselab_cli-0.1.29.tar.gz
Algorithm Hash digest
SHA256 3547dbd0833aa7b6d004aaa246c522f4d7c33600d21713c27e3aea7688c1d3cf
MD5 42223eaff51b6eab0d08081d2e468a56
BLAKE2b-256 eedde3ae02814e5a495ee1125efe0711ff04da981d7c8e9de136beff01270f36

See more details on using hashes here.

File details

Details for the file senselab_cli-0.1.29-py3-none-any.whl.

File metadata

  • Download URL: senselab_cli-0.1.29-py3-none-any.whl
  • Upload date:
  • Size: 45.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for senselab_cli-0.1.29-py3-none-any.whl
Algorithm Hash digest
SHA256 c46fe278f23ac0eccd295d7298e9ba966187e2078f935fdccea34d201c9731ed
MD5 b130c24095b0208a6be1e2be83bde114
BLAKE2b-256 aaf5103bdc22c6f98f3910002201279fe270619755d99ae021a9d43d3a192034

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page