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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

senselab_cli-0.1.46-py3-none-any.whl (54.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: senselab_cli-0.1.46-py3-none-any.whl
  • Upload date:
  • Size: 54.9 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.46-py3-none-any.whl
Algorithm Hash digest
SHA256 6ddb94fc2d68d6c5b37605378ef05fcc406891fbe4917bcbf9b7fb6e28254d04
MD5 1b7124bf9a2f773198230c993dc05c48
BLAKE2b-256 8667bea4c44cfe5e8d1c7037589a4aa51273c2ccae1f82ba61cd178c51185aee

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