Quick start

Create your first AI agent with Klisk in under 5 minutes.

Prerequisites

• Python 3.10 or higher
• A generalist agent installed (Claude, Codex, OpenClaw, etc.)
• An OpenAI API key (or another provider)

Step 1: Install Klisk

pip install klisk

Step 2: Initialize the workspace

klisk

This creates ~/klisk/ and ~/klisk/projects/ where your agents will live.

Step 3: Open your generalist agent

From the Klisk directory, open your favorite agent:

cd ~/klisk
claude    # or codex, openclaw, etc.

Step 4: Ask it to create an agent

Simply describe what you need:

"Create an agent that helps me manage my daily tasks"

The agent will use the Klisk CLI to:

1. Create the project with klisk create
2. Define the necessary tools
3. Configure the agent
4. Open the Studio so you can test it

Step 5: Test your agent

The Studio will open automatically in your browser. From there you can:

• Chat with your agent
• View the agent and tool graph
• Edit properties in real time

You can also test it from the terminal:

klisk run -p my-agent "Hello, what can you do?"

What's next?

• Learn to define tools to give your agent superpowers
• Set up multi-agent for complex scenarios
• Deploy to the cloud to share your agent