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.27.tar.gz (51.0 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.27-py3-none-any.whl (44.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: senselab_cli-0.1.27.tar.gz
  • Upload date:
  • Size: 51.0 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.27.tar.gz
Algorithm Hash digest
SHA256 43c7e37fa3eb6ec4ed44b1e4336b845d0d2be1dcffaf3679343c46a15fe23953
MD5 1e6418ec241b4e013334bf11203bb4df
BLAKE2b-256 5a85f517fde6c86d03dda07c4183ca9048eb8a8603c7220d31d6d8f4693adecd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: senselab_cli-0.1.27-py3-none-any.whl
  • Upload date:
  • Size: 44.6 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.27-py3-none-any.whl
Algorithm Hash digest
SHA256 131b02eaae075f2555663f082297ff5fbd707a0bc2d90ffde3fca38db891847f
MD5 7d8abe3fb1dace134c1720037ece2f16
BLAKE2b-256 72247bda81d9eda938e647cbb581141935dcd65125e9459458f71ef33a5f2a26

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