Managing Projects

A project is a directory on your machine linked to a Discord channel. These commands manage that mapping. For the underlying model, see Channels & Threads.

Adding an existing project

Link a directory that already exists on your machine.

   /add-project <project>   ──▶ pick a recent OpenCode project ──▶ creates its channel
   npx kimaki project add   ──▶ add the current (or any) directory from the CLI

/add-project <project> — autocompletes recent OpenCode projects and creates Discord channels for the one you pick. Run it in the server where you want the channels.
CLI for directories not in the recent list:

12345678# Add the current directory
npx -y kimaki project add

# Add a specific directory
npx -y kimaki project add /code/web-app

# Specify the server when the bot is in multiple
npx -y kimaki project add ./web-app --guild 123456789

Creating a brand new project

/create-new-project <name> creates a new project folder, initializes git, sets up the channel, and starts a session, all in one step. Great for spinning up a fresh repo entirely from Discord.

Removing a project

/remove-project <project> removes the Discord channels for a project. The directory on your machine is left untouched; only the channel mapping is deleted.

From the CLI you can remove individual channel mappings by channel ID (useful for cleaning duplicates without deleting the Discord channel):

1npx -y kimaki project remove <channel-id>

Listing projects

From the CLI:

1npx -y kimaki project list

This shows every directory currently registered with the bot, including the guild (server) name each channel belongs to. The --json flag outputs machine-readable data with guild_id and guild_name fields for disambiguation when the same project is registered on multiple servers.