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:
takopi config set projects.happy-gadgets.path "~/dev/happy-gadgets"
[projects.happy-gadgets]
path = "~/dev/happy-gadgets"
Target a project from chat¶
Send:
/happy-gadgets pinky-link two threads
Project-specific settings¶
Projects can override global defaults:
takopi config set projects.happy-gadgets.path "~/dev/happy-gadgets"
takopi config set projects.happy-gadgets.default_engine "claude"
takopi config set projects.happy-gadgets.worktrees_dir ".worktrees"
takopi config set projects.happy-gadgets.worktree_base "master"
[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:
takopi config set watch_config true
watch_config = true
Set a default project¶
If you mostly work in one repo:
takopi config set default_project "happy-gadgets"
default_project = "happy-gadgets"