docs: call out default worktrees dir (#64)

This commit is contained in:
banteg
2026-01-07 22:31:19 +04:00
committed by GitHub
parent 740b636234
commit 40be0aeb6f
2 changed files with 13 additions and 0 deletions
+9
View File
@@ -30,6 +30,15 @@ default_engine = "codex" # optional, per-project override
worktree_base = "master" # optional, base for new branches
```
Note on `worktrees_dir`:
- The default `.worktrees` lives inside the repo root. You'll see it as an
untracked directory (with nested git worktrees) unless you ignore it.
- Options:
- add `.worktrees/` to your repo `.gitignore`, or
- set `worktrees_dir` to a path outside the repo (e.g. `~/.takopi/worktrees/<alias>`).
- add it to `.git/info/exclude` if you prefer a local-only ignore.
Validation rules:
- `projects` is optional.
+4
View File
@@ -100,6 +100,10 @@ default_engine = "codex"
worktree_base = "master"
```
note: the default `worktrees_dir` lives inside the repo, so `.worktrees/` will
show up as untracked unless you ignore it (add to `.gitignore` or
`.git/info/exclude`), or set `worktrees_dir` to a path outside the repo.
## usage
start takopi in the repo you want to work on: