tasktree-manager 2.9.0__tar.gz → 2.11.0__tar.gz

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/CHANGELOG.md

@@ -15,6 +15,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Git hooks support
 - Custom task metadata
 
+## [2.11.0] - 2026-07-30
+
+### Added
+- Add agent dashboard, forge-aware safety, finish/status CLI
+
+### Changed
+- **cli**: Collapse multi-line f-string per ruff format
+
+
+## [2.10.0] - 2026-07-23
+
+### Added
+- **cli**: Add headless CLI for task management
+
+
 ## [2.9.0] - 2026-07-14
 
 ### Added

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasktree-manager
-Version: 2.9.0
+Version: 2.11.0
 Summary: TUI application for managing worktree-based tasks
 License-File: LICENSE
 Requires-Python: >=3.10

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/README.md

@@ -18,6 +18,10 @@
 - ⌨️ **Keyboard-First** - Navigate and control everything without touching the mouse
 - 🚀 **Fast & Responsive** - Parallel git operations with loading indicators
 - 🔧 **Flexible Configuration** - TOML config file, custom keybindings, environment variables
+- 🤖 **Headless CLI** - Create, list, inspect, finish, and delete tasks from scripts and AI agents without opening the TUI
+- 🛰️ **Agent Dashboard** - Live Claude Code session state per worktree (from `claude agents`), plus one-key background-agent dispatch — the multi-repo agent view Claude Code lacks natively
+- 🔀 **Forge-Aware Safety** - MR/PR and CI state via `glab`/`gh`; squash- and rebase-merged branches count as merged instead of blocking deletion forever
+- 📦 **Finish Flow with Archives** - Ending a task saves its combined diff (committed-but-unmerged + uncommitted) to an archive before deleting
 
 ## 📊 Status Indicators
 
@@ -25,12 +29,15 @@
 |-----------|---------|
 | `●` red | Uncommitted changes |
 | `◆` blue | Has CLAUDE.md file |
-| `⟳` magenta | Claude Code session running |
+| `⟳` magenta | Claude Code session running / agent working |
 | `!` yellow | Claude Code session waiting for input |
+| `▣` green | Agent session ready (idle) |
 | `✓` green | Clean worktree / Claude session ended |
 | `✗ N` red | N files changed |
 | `↑N` green | N commits ahead of remote |
 | `↓N` yellow | N commits behind remote |
+| `○` green / `●` magenta / `×` red | MR open / merged / closed |
+| `◐` yellow / `✔` green / `✘` red | CI running / passed / failed |
 
 ## 🚀 Quick Start
 
@@ -63,6 +70,27 @@ On first run, you'll configure:
 
 For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 
+### Headless CLI
+
+Running `tasktree-manager` with arguments skips the TUI — useful for scripts and AI-agent
+workflows (e.g. a skill that creates a Jira ticket and then the matching task):
+
+```bash
+tasktree-manager create DIC-1901-argocd-tls --repos backend,frontend  # --base overrides the default base branch
+tasktree-manager list --json     # tasks with repos and dirty state (plain text without --json)
+tasktree-manager repos           # available repos in REPOS_DIR
+tasktree-manager add-repo DIC-1901-argocd-tls infra
+tasktree-manager status                       # current task inferred from $PWD; also --json / --oneline / --forge
+tasktree-manager finish DIC-1901-argocd-tls   # safety sweep -> archive diff -> delete; --push / --no-archive / --force
+tasktree-manager delete DIC-1901-argocd-tls   # low-level delete; refuses on unfinished work; --force overrides
+```
+
+Exit code is 0 on success, 1 on failure with the reason on stderr. `delete` and `finish` run
+the same safety check as the TUI (uncommitted, unpushed, or unmerged work blocks deletion);
+with `glab`/`gh` installed, squash/rebase-merged branches are recognized as merged.
+`status --oneline` emits a compact `TASK repoA✓ repoB●2↑1` summary that slots straight into
+a Claude Code statusline or shell prompt.
+
 ## 📖 Documentation
 
 **Complete guides:**
@@ -81,6 +109,7 @@ For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 | `p` | Push all | `o` | Open folder |
 | `P` | Pull all | `Enter` | Open shell |
 | `c` | Claude (resume) | `C` | Claude (new) |
+| `b` | Dispatch agent | `D` | Delete worktree |
 | `r` | Refresh | `s` | Sort tasks |
 | `S` | Group worktrees | `m` | Messages |
 | `t` | Cycle theme | `Tab` | Next panel |
@@ -160,11 +189,13 @@ For comprehensive troubleshooting, see the [Troubleshooting Guide](docs/troubles
 
 ## 🗺️ Roadmap
 
-Current: **v0.2.0** - Configuration system, themes, comprehensive documentation
+Recently shipped: agent dashboard (per-worktree Claude session badges + background dispatch),
+forge-aware merged detection (glab/gh, squash/rebase merges), MR/CI status badges,
+guided `finish` flow with diff archiving, `status` subcommand for scripts and statuslines.
 
 Upcoming:
-- **v0.3.0** - Search/filter, task templates, archiving
-- **v0.4.0** - JIRA integration, git hooks, automation
+- **v0.3.0** - Search/filter, task templates
+- **v0.4.0** - JIRA status column, git hooks, automation
 - **v1.0.0** - Stable release
 
 See [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md) for details.

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/docs/configuration.md

@@ -79,6 +79,11 @@ repos_dir = "/Users/username/repos"
 # Created automatically if it doesn't exist
 tasks_dir = "/Users/username/tasks"
 
+# Directory for finished-task diff archives
+# Relative paths resolve under tasks_dir (never the current directory)
+# Default: "" (uses <tasks_dir>/.archive)
+archive_dir = ""
+
 # ============================================================================
 # UI Settings
 # ============================================================================
@@ -99,6 +104,16 @@ show_hidden_files = false
 # Default: 30
 refresh_interval = 30
 
+# Claude agent session poll interval in seconds (0 = disabled)
+# Polls `claude agents --json` for per-worktree session state badges
+# Default: 10
+agent_poll_interval = 10
+
+# MR/CI forge status poll interval in seconds (0 = disabled)
+# Polls glab/gh for MR and pipeline state badges in the worktree list
+# Default: 60
+forge_poll_interval = 60
+
 # ============================================================================
 # Git Settings
 # ============================================================================
@@ -170,6 +185,32 @@ claude_repo_memory = true
 # Default: "" (uses $SHELL, falls back to /bin/bash)
 shell = ""
 
+# Path to glab executable (GitLab CLI, used for MR/CI status)
+# Default: "glab" (searches PATH)
+glab_path = "glab"
+
+# Path to gh executable (GitHub CLI, used for PR/CI status)
+# Default: "gh" (searches PATH)
+gh_path = "gh"
+
+# ============================================================================
+# Forge (MR/PR state via glab/gh)
+# ============================================================================
+[forge]
+
+# Query MR/PR and CI state from GitLab/GitHub CLIs.
+# Used for worktree badges, squash-merge-aware safety checks, and
+# `status --forge`. Set to false to disable all forge lookups
+# (e.g. air-gapped environments).
+# Default: true
+enabled = true
+
+# Extra self-hosted GitLab hostnames. Hosts containing "gitlab" and
+# github.com are auto-detected from each repo's origin URL; list hosts
+# here only when the hostname doesn't contain "gitlab".
+# Default: []
+gitlab_hosts = []
+
 # ============================================================================
 # Keybindings
 # ============================================================================
@@ -187,6 +228,7 @@ help = "?"              # Show help modal
 new_task = "n"          # Create new task
 add_repo = "a"          # Add repository to current task
 delete_task = "d"       # Delete/finish task
+delete_worktree = "D"   # Remove single worktree from task (shift+d)
 
 # Git operations
 open_lazygit = "g"      # Open lazygit in selected worktree
@@ -201,6 +243,7 @@ refresh = "r"           # Refresh git status
 # Claude Code integration
 open_claude_resume = "c"    # Open Claude CLI (resume if a session exists, else new)
 open_claude_gui_code = "C"  # Open Claude desktop on Code page in task folder (shift+c)
+dispatch_agent = "b"        # Dispatch background Claude agent in selected worktree
 
 # Messages panel
 toggle_messages = "m"       # Show/hide the activity messages panel
@@ -245,6 +288,7 @@ blocklist = [
 |------------|------|-----------|---------------------|------------------------------------------------|
 | `repos_dir` | path | `~/repos` | `REPOS_DIR`         | Directory containing your git repositories     |
 | `tasks_dir` | path | `~/tasks` | `TASKS_DIR`         | Directory where task worktrees will be created |
+| `archive_dir` | path | `""` (`<tasks_dir>/.archive`) | - | Directory for finished-task diff archives |
 
 ### Details
 
@@ -280,6 +324,8 @@ tasks_dir = "/Volumes/FastSSD/worktrees"
 | `theme`            | string  | `tasktree`      | `TASKTREE_THEME`     | Color theme for the interface            |
 | `show_hidden_files` | boolean | `false`         | -                     | Show hidden files in listings            |
 | `refresh_interval`  | integer | `30`            | -                     | Auto-refresh interval in seconds (0 = disabled) |
+| `agent_poll_interval` | integer | `10`          | -                     | Claude agent session poll in seconds (0 = disabled) |
+| `forge_poll_interval` | integer | `60`          | -                     | MR/CI forge status poll in seconds (0 = disabled) |
 
 ### `theme`
 
@@ -354,6 +400,23 @@ refresh_interval = 15  # Refresh every 15 seconds
 | `lazygit_path` | string | `"lazygit"` | -                   | Path to lazygit executable           |
 | `hunk_path`   | string | `"hunk"`    | -                   | Path to hunk diff-viewer executable  |
 | `shell`       | string | `""`        | `SHELL`             | Shell to use when opening terminals  |
+| `glab_path`   | string | `"glab"`    | -                   | Path to GitLab CLI (MR/CI status)    |
+| `gh_path`     | string | `"gh"`      | -                   | Path to GitHub CLI (PR/CI status)    |
+
+## Forge Settings
+
+MR/PR and CI state is looked up through the GitLab (`glab`) and GitHub (`gh`)
+CLIs. The provider is auto-detected per repository from its `origin` URL:
+`github.com` uses `gh`; hosts containing "gitlab" (or listed in
+`gitlab_hosts`) use `glab`; anything else (including local-path remotes) is
+skipped. Lookups power the worktree MR/CI badges, squash-merge-aware safety
+checks, and `tasktree-manager status --forge`. Missing CLIs or network
+failures degrade silently — features fall back to plain git behavior.
+
+| Option         | Type       | Default | Description                                        |
+|----------------|------------|---------|----------------------------------------------------|
+| `enabled`      | boolean    | `true`  | Master switch for all forge lookups                |
+| `gitlab_hosts` | array[str] | `[]`    | Extra self-hosted GitLab hostnames to auto-detect  |
 
 ### Details
 

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/docs/user-guide.md

@@ -364,6 +364,7 @@ Useful when you're spinning up several similar tasks that share the same set of
 |---------|-------------------------|------------------------------------------------------------|
 | `c`     | Open Claude CLI         | Resume the task's Claude Code session if one exists, otherwise start a new one |
 | `C`     | Open Claude desktop     | Open the Claude desktop app on the Code page at the task folder |
+| `b`     | Dispatch agent          | Run a background Claude agent (`claude --bg`) in the selected worktree |
 
 **How it works:**
 - `c` opens Claude Code CLI in a new Ghostty terminal tab at the task directory.
@@ -374,6 +375,35 @@ Useful when you're spinning up several similar tasks that share the same set of
 - Both variants point the session's Claude Code auto-memory at a shared pool (`claude_memory_dir`, default `~/.claude/tasktree-memory`). Task folders are not git repos, so without this each task would get its own memory directory that is orphaned when the task is deleted; with the shared pool, what Claude learns in one task carries over to future tasks.
 - Each worktree additionally gets its own `.claude/settings.local.json` pointing auto-memory at the **main repo's** memory directory (`claude_repo_memory`, enabled by default). Sessions started manually inside a worktree (`cd` + `claude`) would otherwise key their memory to the worktree path and lose it when the worktree is deleted; with this, what Claude learns about a repo persists across worktrees and is shared with sessions in the main checkout. The file is git-excluded so worktrees stay clean, and these sessions also report status back to the task indicator.
 
+**Agent dashboard:**
+
+Claude Code's native agent view is scoped to a single repository — it has no concept of a
+task spanning several repos. tasktree-manager fills that gap:
+
+- The worktree list polls `claude agents --json` (every `agent_poll_interval` seconds,
+  default 10) and shows a per-worktree session badge: `⟳` working, `!` needs input,
+  `▣` ready/idle. Any Claude session whose working directory is inside a worktree counts,
+  whether started from the TUI, the dashboard, or a plain terminal.
+- `b` prompts for an instruction and dispatches a background agent
+  (`claude --bg -n <task>/<repo>`) into the selected worktree. Dispatch results land in
+  the messages panel (`m`), and the session appears in `claude agents` under the
+  `<task>/<repo>` name. Dispatch to several worktrees in parallel is fine.
+- If the `claude` CLI is missing or too old for `agents --json`, polling disables itself
+  after three failed attempts (one note in the messages panel) — the rest of the app is
+  unaffected.
+
+**Forge badges (MR/CI):**
+
+With the GitLab (`glab`) or GitHub (`gh`) CLI installed and authenticated, the worktree
+list also shows each branch's MR state (`○` open, `●` merged, `×` closed) and CI state
+(`◐` running, `✔` passed, `✘` failed; GitHub only — GitLab's MR list API carries no
+pipeline data). The provider is auto-detected from each repo's origin URL; self-hosted
+GitLab works when the hostname contains "gitlab" or is listed under `[forge]
+gitlab_hosts`. The same lookup makes safety checks recognize squash/rebase-merged
+branches: a branch whose MR is merged no longer blocks task deletion even though
+`git merge-base` cannot see the merge. Set `[forge] enabled = false` to turn all of
+this off.
+
 ### General
 
 | Key     | Action                  | Description                                  |
@@ -623,14 +653,24 @@ d (delete task)
 - tasktree-manager checks for uncommitted changes
 - Checks for unpushed commits
 - Offers to push before deletion
+- With `glab`/`gh` installed, branches whose MR/PR was squash- or rebase-merged count as
+  merged (plain `git merge-base` cannot see those merges)
 - Force delete available (with confirmation)
 
 **What happens on delete:**
+- ✅ The task's remaining diff (committed-but-unmerged + uncommitted work) is archived to
+  `archive_dir` (default `<tasks_dir>/.archive/<task>-<timestamp>.patch`) before anything
+  is removed — the messages panel (`m`) shows the archive path
 - ✅ Worktrees removed from `TASKS_DIR`
 - ✅ Branches remain on remote (if pushed)
 - ✅ Original repos in `REPOS_DIR` untouched
 - ❌ Local branches remain in original repos (cleanup manually if needed)
 
+**From scripts:** `tasktree-manager finish <task>` runs the same guided flow headlessly
+(safety sweep → optional `--push` → archive → delete), and `tasktree-manager status
+[--json|--oneline] [--forge]` reports per-worktree state — see the README's Headless CLI
+section.
+
 ### Manual Cleanup
 
 If tasktree-manager crashes or worktrees are corrupted:

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/pyproject.toml

@@ -70,7 +70,7 @@ version-file = "tasktree_manager/_version.py"
 # Semantic Release Configuration
 [tool.semantic_release]
 version_toml = ["pyproject.toml:tool.semantic_release.version"]
-version = "2.9.0"
+version = "2.11.0"
 tag_format = "v{version}"
 branch = "main"
 commit_message = "chore(release): {version} [skip ci]"

{tasktree_manager-2.9.0 → tasktree_manager-2.11.0}/tasktree_manager/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.9.0'
-__version_tuple__ = version_tuple = (2, 9, 0)
+__version__ = version = '2.11.0'
+__version_tuple__ = version_tuple = (2, 11, 0)
 
 __commit_id__ = commit_id = None