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.56.tar.gz (78.1 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.56-py3-none-any.whl (70.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: senselab_cli-0.1.56.tar.gz
  • Upload date:
  • Size: 78.1 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.56.tar.gz
Algorithm Hash digest
SHA256 1730315ca980b1f287b6231c111a2418ac26a22149945d704203ad3e3f5b8234
MD5 34d2fc92e5362fd1eb45393c1883d250
BLAKE2b-256 67446664d090cda1e6ab51829ed19cf1b13a0aabdd44c36141bfd766b92116bd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: senselab_cli-0.1.56-py3-none-any.whl
  • Upload date:
  • Size: 70.8 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.56-py3-none-any.whl
Algorithm Hash digest
SHA256 b043ddb49eb5ae224c761586aa56833c6ce1d9ed8db4391d9f81babe72e9b204
MD5 f2ca3f2744a278a9a785e764bd26f564
BLAKE2b-256 62ac9f39900ba90d56e08a40849a2e08c0438fa916f0914e0e6cd4df0e548152

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