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.34.tar.gz (55.4 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.34-py3-none-any.whl (49.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: senselab_cli-0.1.34.tar.gz
  • Upload date:
  • Size: 55.4 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.34.tar.gz
Algorithm Hash digest
SHA256 af0710d62c1076ba221fc968a5566babd833b0de89eac05e95c5b917fca75193
MD5 7e0c86f5f158eba8f985069d0873a6a4
BLAKE2b-256 dd7846ef84a702caf11eddf806e474e7eff8ab86ce7ba761daff33c7a9840fa8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: senselab_cli-0.1.34-py3-none-any.whl
  • Upload date:
  • Size: 49.0 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.34-py3-none-any.whl
Algorithm Hash digest
SHA256 4e6776c0f63984032948d849ba8b60582f9d152c6d53d576122a307f5a07df63
MD5 8e755b1e13d3a00000cef2bb5b8d8607
BLAKE2b-256 c7036af61e048a2e33db89d8270a12691ec2ff5a632b1000b0168a2dee52ecd1

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