delete
- --keep-branch - Keep the git branch after removing worktree
- -y, --yes - Skip confirmation prompts

prune
- -y, --yes - Skip confirmation prompts

init-devcontainer
- --image - Base Docker image
- --packages - Space-separated apt packages to install
- --ports - Comma-separated ports to forward (e.g., 3000,8080)
- --postcreate - Command to run after container creation
- --mount-node-modules - Add node_modules volume mount

completion
- --setup - Install shell completion (bash/zsh)
- --cleanup - Remove shell completion

Shell Completion

Tab completion makes using twig much faster by auto-completing commands and git branches.

$3

`bash


Install shell completion (works for bash and zsh)

To remove completion:
`bash
twig completion --cleanup
`

$3

- Commands: branch, list, delete, prune, init-devcontainer (and all their aliases: b, ls, d, p, i)
- Git branches: When using twig branch , all your local git branches will be suggested
- Worktree branches: When using twig delete , only branches that have active worktrees will be suggested

Configuration

twig allows you to configure which editor to open when switching to a worktree. While the shell has an $EDITOR variable, most developers set it to vim for terminal use, even if they prefer Cursor, VS Code, or Claude for their main development.

$3

twig looks for configuration in the following order (first match wins):

1. Per-project: .twig file in the repository root
2. Global:
- ~/.config/twig/config.json (Linux/macOS)
- %APPDATA%\twig\config.json (Windows)
3. Smart defaults: Auto-detected based on project markers (see below)
4. Fallback: Tries cursor, then code commands

$3

You can use either a simple string format or a structured format for more control:

Simple format (most common):
`json
{
"editor": "cursor"
}
`

Structured format (with custom arguments):
`json
{
"editor": {
"command": "cursor",
"args": ["--wait", "."]
}
}
`

$3

Common editor shortcuts are recognized and will use friendly names in output:

- cursor - Cursor AI editor
- code - Visual Studio Code
- claude - Claude.ai editor
- vim - Vim
- nvim - Neovim
- emacs - Emacs
- nano - Nano
- Custom commands and full paths are also supported

$3

If no configuration file is found, twig will try to detect your preferred editor based on project markers:

- .cursor/ folder → Opens with Cursor
- .vscode/ folder → Opens with VS Code
- .claude/ folder → Opens with Claude

This means projects will automatically open in the right editor without any configuration in most cases.

$3

Skip editor launch entirely (useful if you prefer to open editors manually):
`json
{
"editor": "none"
}
`

Use Vim (great for quick edits):
`json
{
"editor": "vim"
}
`

Use custom editor with specific arguments:
`json
{
"editor": {
"command": "code",
"args": ["--new-window", "--goto", "."]
}
}
`

Use custom editor path:
`json
{
"editor": "/usr/local/bin/my-editor"
}
`

Per-project override: Create a .twig file in your repo:
`bash
echo '{"editor": "vim"}' > .twig
`

You can add .twig to .gitignore for personal preferences, or commit it for team-wide defaults.

Examples

$3

`bash


Switch to a feature branch (creates worktree if it doesn't exist)

`bash


Initialize dev container in your repository

`bash


Work on multiple features simultaneously

When you use twig branch for the first time, it automatically installs a git post-checkout hook that prunes orphaned worktrees. This means if you delete a branch directly (e.g., git branch -D feature/old), the corresponding worktree will be automatically removed the next time you checkout a branch.

You can also manually trigger cleanup anytime:

`bash
twig prune
`

Development

$3

- Node.js 22+
- Git 2.5+

$3

`bash


Clone and install

Note: A pre-commit hook is automatically installed that runs lint and typecheck before each commit.

$3

`bash


Build and run