Projects

Projects let you target any registered repo from Telegram — no need to restart Untether or change directories. Send /myapp fix the tests from your phone and the agent runs in the right repo.

Register a repo as a project#

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

saved project 'happy-gadgets' to ~/.untether/untether.toml

This adds a project to your config:

untether config

untether config set projects.happy-gadgets.path "~/dev/happy-gadgets"

toml

[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:

untether config

untether config set projects.happy-gadgets.path "~/dev/happy-gadgets"
untether config set projects.happy-gadgets.default_engine "claude"
untether config set projects.happy-gadgets.worktrees_dir ".worktrees"
untether config set projects.happy-gadgets.worktree_base "master"

toml

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

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

untether config

untether config set watch_config true

toml

watch_config = true

Set a default project#

If you mostly work in one repo:

untether config

untether config set default_project "happy-gadgets"

toml

default_project = "happy-gadgets"

Related#

• Context resolution
• Worktrees