Metadata-Version: 2.4
Name: kulega
Version: 0.2.0
Summary: Kulega CLI — your AI colleague in the terminal
Author-email: Kulega <hello@kulega.com>
License-Expression: MIT
Project-URL: Homepage, https://kulega.com
Project-URL: Documentation, https://kulega.com/news/kulega-cli-your-ai-colleague-in-the-terminal
Keywords: ai,assistant,cli,agent,productivity
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0

# Kulega CLI

Your AI colleague in the terminal.

> **Requires the [Agent API plan](https://kulega.com/#pricing) ($99/mo)**

## Installation

```bash
pip install kulega
```

## Quick start

```bash
# Save your API key (get one at https://kulega.com/dashboard/api-keys)
kulega auth set-key kul_your_key_here

# Verify it works
kulega auth whoami

# Chat
kulega chat "What should I focus on today?"

# Run a goal
kulega run "Block 2 hours of deep work every morning this week"

# Manage tasks
kulega task list
kulega task add "Review Q2 report" --priority high
kulega task done abc12345
```

## Commands

| Command | Description |
|---|---|
| `kulega auth set-key <key>` | Save your API key |
| `kulega auth whoami` | Verify key and show account |
| `kulega chat "message"` | Ask your AI colleague anything |
| `kulega run "goal"` | Execute a goal autonomously |
| `kulega session` | Interactive multi-turn conversation |
| `kulega task list` | List tasks |
| `kulega task add "title"` | Create a task |
| `kulega task done <id>` | Mark a task done |
| `kulega goals list` | List saved goals |
| `kulega goals add "goal"` | Save a new goal |
| `kulega schedule add "every morning at 8am" "summarise my emails"` | Schedule a recurring goal |
| `kulega schedule list` | List scheduled goals |

All commands support `--json` for pipe-friendly scripting.

## Requirements

- Python 3.9+
- Active [Kulega Agent API plan](https://kulega.com/#pricing)
- API key from [kulega.com/dashboard/api-keys](https://kulega.com/dashboard/api-keys)

## Links

- [kulega.com](https://kulega.com)
- [Setup guide](https://kulega.com/news/kulega-cli-your-ai-colleague-in-the-terminal)
