workon

Resolve branch descriptions to worktrees and attach Claude workspace sessions.

1|4|Updated Oct 27, 2014
One-click install
npx skills add https://github.com/rjernst/dotfiles --skill workon-rjernst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workon
Source: https://github.com/rjernst/dotfiles/tree/main/claude/skills/workon
Command: npx skills add https://github.com/rjernst/dotfiles --skill workon-rjernst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the friction of manually finding the right branch, creating or reusing a worktree, and setting up a consistent session environment for focused work.

Core Features & Use Cases

  • Semantic branch workspace switching: Resolve a user’s natural-language request to the most relevant branch from local and remote branch lists, then open the matching workspace.
  • Worktree + session orchestration: Check whether a worktree and a wt-* Claude workspace session already exist; create them when missing, then attach to the agent window.
  • Git-aware reliability: Uses ta primitives to ensure worktree status, creation, listing, and workspace attach happen in a controlled, deterministic flow.

Quick Start

Ask to open the workspace for a branch described in plain English, for example: “Work on the UI updates work branch.”

Frequently Asked Questions about workon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch to a git branch workspace using a natural language description?

Switch to a git branch workspace by describing the work in plain English, such as "work on the UI updates branch." The tool semantically matches your description to local and remote branches, then opens or creates the matching workspace.

How does semantic branch resolution work for git worktrees?

Semantic branch resolution matches your natural-language request against local and remote git branch lists to find the most relevant branch. It avoids exact name matching, letting you jump into branch-focused work without remembering precise branch names.

Can I automatically create a git worktree and start a Claude session at the same time?

Yes, you can automatically create a missing git worktree and start a Claude workspace session simultaneously. The tool checks for existing worktrees and `wt-*` sessions, creates them if needed, and attaches to the agent window.

Do I need to manage tmux sessions directly when switching git workspaces?

No, you do not need to manage tmux sessions directly. The tool uses `ta wt` and `ta workspace` primitives to handle worktree creation, session orchestration, and workspace attachment in a controlled, deterministic flow.

What is the best way to manage multiple git worktrees for parallel development?

The best way to manage multiple git worktrees is using a workspace switching tool that orchestrates worktree creation and session attachment. This eliminates manual setup friction by automatically resolving branches and opening consistent session environments.

Why does my git branch worktree session fail to attach correctly?

Git branch worktree session attachment fails when worktree status or session creation is not controlled. Using `ta` primitives ensures worktree creation, listing, and workspace attach happen in a deterministic flow, preventing inconsistent session environments.