Skip to main content

Getting Started with Kaji

There are two ways to use Kaji. Choose the one that fits your workflow:

MethodBest for
MattermostBusiness users, quick questions, team collaboration
Code-Server sessionDevelopers, longer working sessions, full IDE access

Option 1: Kaji via Mattermost​

The easiest way to get started — no session setup required.

Step 1: Open any Mattermost channel or thread​

Navigate to the channel where you want to work with Kaji.

Step 2: Start a Kaji session​

Post a message in a thread with @kaji and describe your task:

@kaji can you pull our Q1 sales data from Dremio and summarize it?

Kaji will reply with a session confirmation:

🚀 OpenCode Session Started
Owner: @you
Session: ses_xxxxx

Reply in this thread to send prompts.

Step 3: Continue the conversation​

Reply in the same thread with follow-up requests. Kaji keeps track of the conversation context.

Option 2: Kaji via Code-Server Session​

For a full development environment with an AI assistant built in.

Step 1: Launch a Kaji session on Shakudo​

  1. Go to the Shakudo dashboard
  2. Click Start a Session
  3. Select Kaji as the session type
  4. Click Start session
note

Session startup takes 30–90 seconds depending on resource availability.

Step 2: Open Code-Server​

Once the session is running, click the VS Code access button to open Code-Server in your browser.

Kaji Code-Server session

Step 3: Start Kaji in the terminal​

Open the terminal in Code-Server (Ctrl+` or Terminal → New Terminal) and run:

kaji

You'll see the Kaji welcome screen and the AI assistant is ready to use.

Kaji terminal view

Keyboard shortcuts in Kaji​

ShortcutAction
Ctrl+TSwitch between agent variants
TabView available agents
Ctrl+PBrowse all commands
EscInterrupt current operation

What's connected by default?​

When you start a Kaji session, these integrations are automatically connected:

  • Mattermost — team messaging
  • ClickUp — task management
  • Notion — documents and wikis
  • Dremio — data analytics
  • Supabase — database
  • Neo4j — graph database
  • Gamma — presentations
  • and more...

See the full list in MCP Integrations.