Metadata-Version: 2.4
Name: senselab-cli
Version: 0.1.18
Summary: SenseLab CLI for managing AI agents
Author: SenseLab
Project-URL: Homepage, https://github.com/raia-live/backend-api
Project-URL: Repository, https://github.com/raia-live/backend-api
Keywords: senselab,cli,devops,sre,orchestrator
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Requires-Dist: PyYAML>=6.0

# 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 assistant configuration from YAML

## Install

### Recommended (pipx)

```bash
pipx install senselab-cli
```

### pip

```bash
pip install senselab-cli
```

## Quick start

1) Login:

```bash
sense-cli login --token "<YOUR_JWT_TOKEN>"
```

2) Check configuration and auth:

```bash
sense-cli config list -o json
```

3) List your project/agents/functions:

```bash
sense-cli projects
sense-cli agent list
sense-cli agent <agent_name_or_id> function --list
```

4) Chat with an agent:

```bash
sense-cli agent <agent_name_or_id> --chat "Summarize current production incidents"
```

or run a specific function on an agent:

```bash
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 assistant.yaml` - declaratively create/update assistant setup
- `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

Default config path:
- `~/.sense-cli/config.json`

## Help

```bash
sense-cli --help
sense-cli <command> --help
```
