A command-line utility for managing git worktrees with isolated profiles and databases.

Install

mkdir -p .claude/skills/wt-kernandrey && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13157" && unzip -o skill.zip -d .claude/skills/wt-kernandrey && rm skill.zip

Installs to .claude/skills/wt-kernandrey

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Manage git worktrees with client profiles (create, run, list, remove, template)
79 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Create a new git worktree with client profiles
  • Run Odoo within a specific worktree context
  • Remove a worktree, its database, and branch
  • List active worktrees, databases, and client annotations
  • Create or refresh a template database for clients

How it works

This skill manages git worktrees by providing commands to create, run, remove, and list them, along with client-specific configurations for addons, template databases, and port assignments.

Inputs & outputs

You give it
A command and optional client name/branch for worktree management
You get back
A new worktree, running Odoo instance, or a list of worktrees/clients

When to use wt

  • Create git worktree
  • Switch client contexts
  • Manage development databases
  • List active worktrees

About this skill

Worktree Manager

Manages git worktrees with per-client addon paths, template DBs, and port assignment via ~/bin/wt.

Context

Gather before acting:

pwd
git branch --show-current
wt list

Commands

CommandDescription
wt create [--client <name>] <branch>Create worktree + DB from template
wt run [--client <name>] <branch>Start Odoo (blocking; auto-detects client)
wt remove <branch>Delete worktree + DB + branch
wt listShow worktrees, DBs, client annotations
wt clientsList client profiles from .wt.toml
wt template [--client <name>] [source_db]Create/refresh template DB

Execution

  1. If $ARGUMENTS is empty — run wt list.
  2. Otherwise run wt $ARGUMENTS.
  3. After create — show path and next steps.
  4. After run — warn it's blocking. Suggest nohup wt run <branch> > /tmp/odoo-<branch>.log 2>&1 &.
  5. If create --client fails on missing template — guide first-time setup below.

First-Time Client Template

# 1. Seed DB with client modules
python3 /home/kern/projects/freight-erp/vendor/odoo/odoo-bin \
  -c docker/odoo-local.conf \
  -d <seed_db> --without-demo=False \
  --addons-path=vendor/odoo/addons,custom-addons,third-party-addons,clients/<client>/addons \
  -i <modules> \
  --db_host localhost --db_port 50010 --db_user odoo --db_password odoo \
  --stop-after-init

# 2. Save as template
wt template --client <client> <seed_db>

Config (.wt.toml)

[clients.<name>]
addons = ["clients/<name>/addons"]
template = "template_<project>_<name>"
base_port = <port>          # required; fallback 10000 if omitted

When not to use it

  • When not using git worktrees for development
  • When client profiles are not needed for project management
  • When managing Odoo instances without worktree isolation

Limitations

  • Requires a `.wt.toml` configuration file for client profiles
  • The `run` command is blocking
  • First-time client template setup requires manual database seeding

How it compares

This skill extends standard git worktree functionality by integrating client-specific profiles, enabling isolated development environments with custom addons and databases, which is more tailored than generic worktree usage.

Compared to similar skills

wt side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
wt (this skill)04moReviewIntermediate
resolve-conflicts818moReviewIntermediate
openspec-onboard106moReviewBeginner
codex-cli-bridge99moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry