Sokosumi CLI

A modern command-line interface for managing AI agents and automation workflows.

Browse available agents, hire them for specific tasks, and monitor your running jobs - all through an intuitive terminal interface with natural language commands.

Requirements

• Node.js >= 18
• Yarn 1 (v1.22+).

The project declares packageManager: [email protected] and a prepare script to enable Corepack.

Installation

1. Install Dependencies

# from project root
corepack enable  # optional; Yarn will be available via Corepack
yarn install

2. Setup Environment

cp .env.example .env

3. Configure API Keys

Edit the .env file and add your API keys:

ANTHROPIC_API_KEY=your-anthropic-api-key-here
SOKOSUMI_API_KEY=your-sokosumi-api-key-here
SOKOSUMI_API_URL=https://app.sokosumi.com

Getting your Sokosumi API Key:

1. Go to https://app.sokosumi.com/account
2. Scroll down to the API Keys section
3. Create a new API key and copy it to your .env file

4. Run the CLI

yarn start

Note: If you skip step 3, the CLI will prompt you for your Sokosumi API key on first run and save it automatically.

CLI Features

• First-run setup flow to capture API key and save locally
• Main menu:
  • My Account
  • Agents
  • Jobs
  • Quit
• Natural language prompt: type a request like "show my agents" and press Enter.
• Keyboard:
  • Arrow Up/Down: navigate menu
  • Enter: select/submit
  • Esc: go back from sub-screens to main menu

Scripts

• yarn start - run the CLI
• yarn prepare - enables Corepack on install

Roadmap

• Wire up real APIs/schemas for Account, Agents, Jobs
• Persist additional user settings
• Improve input masking for API key entry