npm package: @kolaborate/kola-cli
Description: Agent-first CLI for the Kolaborate ecosystem
Latest version: 0.1.1

# Kola CLI

The Agent-first CLI for the Kolaborate ecosystem.

## Features

- **RBAC-first**: Every command is protected by Role-Based Access Control.
- **Audit-Logged**: Every state change (create, update, enroll, etc.) is logged for non-repudiation.
- **MCP Native**: Supports Model Context Protocol (MCP) for seamless AI agent integration.
- **Unified Auth**: Supports both human (Firebase) and agent (API key) actor resolution.

## Installation

**npm global install:**
```bash
npm install -g @kolaborate/kola-cli
```

**npx (no install):**
```bash
npx @kolaborate/kola-cli --help
```

**Binary download:**

Pre-built binaries for macOS (arm64, x64) and Linux (x64) are available on the [GitHub Releases page](https://github.com/Kolaborate-Platforms/kolaborate-monorepo/releases). Download the binary for your platform, make it executable, and place it on your `PATH`.

## Quick Start

```bash
# Sign in with your Kolaborate account
kola auth login

# Browse available jobs
kola jobs list

# View your profile
kola profile get

# Check available courses
kola academy list
```

## Authentication

### For humans

```bash
kola auth login
```

Opens an interactive login flow and saves a Firebase token to your local config.

### For agents

```bash
kola auth apikey create --name "my-agent" --scopes "jobs:read,chats:read"
```

Creates a scoped API key. Pass it as `KOLA_API_KEY` in your agent's environment. No browser required.

## MCP Setup

### Hosted (recommended)

Point your MCP client at the managed HTTP endpoint. No local setup required.

```json
{
  "mcpServers": {
    "kolaborate": {
      "url": "https://mcp.kolaborate.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KOLA_API_KEY"
      }
    }
  }
}
```

### Local stdio (development)

For development or self-hosted Convex deployments, run the MCP server locally via stdio:

```json
{
  "mcpServers": {
    "kolaborate": {
      "command": "kola",
      "args": ["serve", "mcp"],
      "env": {
        "KOLA_API_KEY": "your_agent_api_key_here"
      }
    }
  }
}
```

## Commands

| Command group       | Description                                              |
| ------------------- | -------------------------------------------------------- |
| `kola auth`         | Login, logout, and manage API keys for humans and agents |
| `kola config`       | View and set local CLI configuration                     |
| `kola jobs`         | Browse, create, and manage marketplace job postings      |
| `kola kolaborators` | Search and manage kolaborator profiles and relationships  |
| `kola chats`        | Send and read direct messages and channel conversations  |
| `kola profile`      | Manage your user identity, avatar, and public profile    |
| `kola quotations`   | Create and track project quotations and proposals        |
| `kola careers`      | Browse open positions and submit career applications     |
| `kola academy`      | Enroll in courses, track progress, and trigger AI gen    |
| `kola notifications`| List and mark notifications as read                     |
| `kola support`      | Open and view support tickets                            |
| `kola serve`        | Start the MCP server (stdio or HTTP)                     |

## Environment Variables

| Variable       | Description                                                 |
| -------------- | ----------------------------------------------------------- |
| `KOLA_API_KEY` | Agent API key for non-interactive / headless authentication |

All other configuration (Convex URL, Firebase project) is preconfigured. Human users authenticate via `kola auth login` — no environment variables needed.

## License

MIT