The Kulega CLI is live. Install it with pip and your AI colleague moves into your terminal — chat, delegate goals, manage tasks, schedule recurring automations, and see everything Kule has done, all without opening a browser.

The CLI requires an active Agent API plan ($99/mo) and an API key.

Installation

pip install kulega

Save your API key (get one at Dashboard → API Keys):

kulega auth set-key kul_your_key_here
kulega auth whoami

Full command reference

kulega chat

Ask Kule anything. Replies are rendered in markdown by default.

kulega chat "What should I focus on today?"
kulega chat "Summarise my unread emails"
kulega chat "Draft a reply to Alex about the Q2 report"
kulega chat "What is on my calendar tomorrow?" --plain | pbcopy

kulega run

Hand off a goal and let Kule carry it out using your connected Skills — calendar, email, tasks, GitHub, Notion, and more.

kulega run "Block 2 hours of deep work every morning this week"
kulega run "Find all overdue tasks and reschedule them to next Monday"
kulega run "Send the project update to the team"

kulega session

Start a multi-turn interactive conversation. Kule remembers what was said earlier in the session — useful for working through something complex step by step.

kulega session

Type exit or press Ctrl+D to quit.

kulega task

Manage your task list from the terminal.

kulega task list
kulega task list --status todo
kulega task add "Review Q2 report" --priority high --due 2026-04-15
kulega task done abc12345
kulega task delete abc12345

Short 8-character IDs shown in task list work everywhere — no need to paste the full ID.

kulega goals

Manage the goals Kule works toward proactively in the background.

kulega goals list
kulega goals add "Reply to all emails within 24 hours"
kulega goals delete abc12345

kulega schedule

Schedule a goal to run automatically on a recurring schedule. Kule parses the timing in natural language and writes an entry to your system crontab.

kulega schedule add "every morning at 8am" "summarise my unread emails"
kulega schedule add "every Monday at 9am" "create a weekly review task"
kulega schedule list
kulega schedule remove abc12345

You can also use a raw cron expression with the --cron flag:

kulega schedule add --cron "0 8 * * 1-5" "weekdays" "check my calendar for today"

kulega activities

See a timestamped log of everything Kule has done — both actions you triggered and actions the background agent took on your behalf.

kulega activities
kulega activities -n 50
kulega activities --json | jq '.[].description'

kulega config

View and manage your local CLI settings without editing the config file directly.

kulega config show
kulega config set-timezone Europe/London
kulega config set-timezone America/New_York

Setting your timezone ensures Kule schedules things at the right local time.

Pipe-friendly JSON output

Every command supports --json for scripting:

kulega task list --json | jq '.[].title'
kulega goals list --json | jq '.[].text'
kulega activities --json | jq '.[0]'

Configuration

Settings are stored in ~/.kulega/config.json with owner-only file permissions (600). The following environment variable overrides are supported:

KULEGA_API_BASE — override the API endpoint (useful for local dev)

Requirements

Python 3.9 or later
Active Agent API plan ($99/mo)
API key from Dashboard → API Keys

Questions or feedback — hello@kulega.com.