{"id":51136019,"url":"https://github.com/appendjeff/agentic-workflow","last_synced_at":"2026-07-14T01:00:48.883Z","repository":{"id":346023579,"uuid":"1188131821","full_name":"appendjeff/agentic-workflow","owner":"appendjeff","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-24T21:11:23.000Z","size":63,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T23:19:04.833Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appendjeff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T16:56:40.000Z","updated_at":"2026-05-24T21:11:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/appendjeff/agentic-workflow","commit_stats":null,"previous_names":["appendjeff/agentic-workflow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/appendjeff/agentic-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appendjeff%2Fagentic-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appendjeff%2Fagentic-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appendjeff%2Fagentic-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appendjeff%2Fagentic-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appendjeff","download_url":"https://codeload.github.com/appendjeff/agentic-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appendjeff%2Fagentic-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35441637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-25T18:00:29.293Z","updated_at":"2026-07-14T01:00:48.877Z","avatar_url":"https://github.com/appendjeff.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Agentic Workflow\nAn opinionated workflow for parallel AI-assisted feature development using [cmux](https://cmux.com), git worktrees, [Claude Code](https://claude.ai/code) and [LazyVim](https://www.lazyvim.org). This repo contains a couple of shell scripts for the workflow. \n\nhttps://github.com/user-attachments/assets/b25d36db-501f-418a-b34b-902a3af5bd8d\n\n## Motivation\n\nWhen working with agentic AI tools like Claude Code, context isolation matters. Switching branches mid-session or sharing a working directory across multiple features leads to confused agents and tangled diffs.\n\nThese scripts create a clean, reproducible workflow:\n- Each feature gets its own **git worktree** — a fully isolated checkout of the repo on a dedicated branch\n- Each feature gets its own **cmux workspace** — a separate terminal tab, named after the feature\n- Each workspace launches **Claude Code** autonomously, scoped only to that feature's files\n\nThe result: multiple features in flight simultaneously, each with its own AI agent, zero context bleed.\n\n## Dependencies\n\n- [cmux](https://cmux.com) — terminal with workspace/tab management CLI\n- [Claude Code](https://claude.ai/code) — `claude` CLI available in PATH\n- [Neovim](https://neovim.io) — `nvim` CLI available in PATH. I recommend [LazyVim](https://lazyvim-ambitious-devs.phillips.codes/).\n- [gum](https://github.com/charmbracelet/gum) — renders the session controls TUI (menus, confirmations). Install with `brew install gum`.\n- git 2.5+\n\n## Installation\n\nClone or copy the scripts into a directory on your `$PATH`:\n\n```bash\ngit clone https://github.com/appendjeff/agentic-workflow.git ~/agent-bin\n```\n\nAdd `~/agent-bin` to your PATH if needed (e.g. in `~/.zshrc`):\n\n```bash\nexport PATH=\"$HOME/agent-bin:$PATH\"\n```\n\n## Commands\n\n### `new-feature`\n\nRun from anywhere inside a git repository. Creates a new isolated workspace for a feature.\n\n```\n$ new-feature\nFeature name: user auth redesign\n```\n\n**What it does:**\n1. Prompts for a feature name (e.g. `\"user auth redesign\"`)\n2. Slugifies it into a branch name: `feature/user-auth-redesign`\n3. Ensures `.worktrees/` is in `.gitignore` (adds it if missing)\n4. Fetches `origin` and creates a worktree branching from `origin/main`\n5. Opens a new named cmux workspace pointed at the worktree\n6. Starts `claude --dangerously-skip-permissions` in the left pane\n7. Opens LazyVim (in file picker mode) in a right split pane for browsing/reviewing files\n8. Opens a terminal in a bottom split under Claude (~20% height)\n9. Refocuses the Claude pane\n\n**Result:** A new cmux tab named `\"user auth redesign\"` with Claude on the top-left, a terminal on the bottom-left (~20%), and nvim on the right — all scoped to `.worktrees/user-auth-redesign/` on branch `feature/user-auth-redesign`.\n\n---\n\n### `done-feature`\n\nRun from **inside** a feature worktree when the work is complete (merged or abandoned).\n\n```\n$ done-feature\nCleaning up:\n  Branch:    feature/user-auth-redesign\n  Worktree:  /path/to/repo/.worktrees/user-auth-redesign\n  Workspace: 5B485556-0051-4F7C-826D-189F4E61F199\n```\n\n**What it does:**\n1. Guards against running from outside a `.worktrees/` directory\n2. Navigates to the main repo root\n3. Removes the worktree directory\n4. Deletes the local branch (`-d`; prompts before force-deleting if unmerged)\n5. Closes the cmux workspace (last, since this kills the shell)\n\n## Typical workflow\n\n```\n# Start a new feature from any directory inside your repo\n$ new-feature\nFeature name: redesign search\n\n# ... Claude works in the isolated worktree ...\n# ... you review, merge the PR ...\n\n# Clean up from inside the worktree tab\n$ done-feature\n```\n\nMultiple features can be in flight simultaneously — each in its own cmux workspace with its own Claude session.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappendjeff%2Fagentic-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappendjeff%2Fagentic-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappendjeff%2Fagentic-workflow/lists"}