Projects¶

Projects let you route messages to repos from anywhere using /alias.

Register a repo as a project¶

cd ~/dev/happy-gadgets
takopi init happy-gadgets

This adds a project to your config:

[projects.happy-gadgets]
path = "~/dev/happy-gadgets"

Send:

/happy-gadgets pinky-link two threads

Projects can override global defaults:

[projects.happy-gadgets]
path = "~/dev/happy-gadgets"
default_engine = "claude"
worktrees_dir = ".worktrees"
worktree_base = "master"

If you expect to edit config while Takopi is running, enable hot reload:

watch_config = true

If you mostly work in one repo:

default_project = "happy-gadgets"