@axelgar/opentree 1.0.2 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Àxel García Roigé
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,54 @@
+opentree — third-party notices
+==============================
+
+opentree itself is distributed under the MIT Licence; see LICENSE. This file
+records the third-party names, marks and code that opentree touches, and the
+rights it does not claim in them.
+
+
+Trade marks
+-----------
+
+opentree drives coding agents it did not write. It draws each one under that
+agent's own name, wordmark and brand colour so that the agent you are talking
+to is identifiable at a glance, and those wordmarks are reproduced as terminal
+text in pkg/config/agents.go, transcribed from each tool's own splash screen.
+
+  opencode         "opencode", its wordmark and the colour #CFCECD are marks of
+                   the opencode project.
+
+  Claude Code      "Anthropic", "Claude", "Claude Code", the Claude mark and
+                   the colour #D97757 are marks of Anthropic PBC.
+
+  GitHub Copilot   "GitHub", "Copilot", "GitHub Copilot", the Copilot mark and
+                   the colour #A371F7 are marks of GitHub, Inc.
+
+  Gemini CLI       "Google", "Gemini", "Gemini CLI", the Gemini sparkle and the
+                   colour #4285F4 are marks of Google LLC.
+
+All trade marks, service marks, trade names and logos are the property of their
+respective owners. They appear here only to identify the tools opentree can
+drive, descriptively and accurately, and no claim of any right in them is made
+or implied.
+
+opentree is an independent project. It is not affiliated with, sponsored by,
+endorsed by or otherwise connected to any of the owners named above; none of
+them has reviewed or approved it, and its MIT licence grants no rights in
+anyone's marks.
+
+If you own one of these marks and would prefer opentree did not reproduce it,
+open an issue at https://github.com/axelgar/opentree/issues and it will be
+changed.
+
+
+Third-party code
+----------------
+
+opentree redistributes no code belonging to the projects above. The one adapter
+it needs — @agentclientprotocol/claude-agent-acp, which bridges Claude Code onto
+the Agent Client Protocol — is fetched from npm when the user asks for it and
+installed under ~/.opentree/tools, under its own licence. `opentree uninstall`
+removes that directory again.
+
+The Go modules opentree links against are listed in go.mod and carry their own
+licences.

package/README.md

@@ -60,6 +60,16 @@ sudo mv opentree /usr/local/bin/
 go install github.com/axelgar/opentree/cmd/opentree@latest
 ```
 
+### Uninstalling
+
+```bash
+opentree uninstall
+```
+
+Removes what opentree wrote into your home directory: the agent adapters under `~/.opentree/tools` (a few hundred megabytes each), the record of approved setup and run commands, the shell completion script and the global config file. It lists all of it with sizes and asks before removing anything — `--dry-run` lists and stops, `--yes` answers the question from a script.
+
+It never touches a repository. The worktrees under `<repo>/.opentree` are your own work in progress, and `opentree delete <branch>` is what removes those. The binary belongs to whichever of brew, npm or `go install` put it there, so the command that removes it is printed at the end.
+
 ## Quick Start
 
 ```bash
@@ -248,7 +258,7 @@ is queued rather than refused.
 themselves, so having the binary is the whole setup. Claude Code is reached
 through the `claude-agent-acp` adapter, which opentree installs on request into
 `~/.opentree/tools` rather than your global npm root — press `A` in the
-dashboard, pick Claude Code, and it offers the download (303MB, needs `node`).
+dashboard, pick Claude Code, and it offers the download (340MB, needs `node`).
 
 Those four are the whole list. opentree drives agents over ACP and nothing else,
 so an agent without an ACP server has no way in — if one ships support, it
@@ -639,6 +649,30 @@ opentree delete feat/add-dark-mode
 
 ## Troubleshooting
 
+### Start here: `opentree doctor`
+
+```bash
+opentree doctor
+```
+
+Prints what opentree can see — its own version, the versions of git, tmux, gh
+and node, which config file it resolved and what it says, whether this
+repository's setup commands are approved, where state and sockets live, and
+what each workspace's chat is doing. Everything it does is a read, so it is
+safe to run and safe to paste into an issue.
+
+If a problem needs reproducing rather than describing, point opentree at a log
+first:
+
+```bash
+OPENTREE_LOG=/tmp/opentree.log opentree
+```
+
+An environment variable rather than a flag, because the interesting failures
+happen inside `opentree chat`, which a tmux window starts rather than you — and
+the variable is inherited by every process opentree launches. Off by default.
+The file holds branch names, paths and session ids, and is written `0600`.
+
 ### "Error: not a git repository"
 
 opentree must be run from inside a git repository. Navigate to your project root first.
@@ -711,12 +745,31 @@ go build -o opentree ./cmd/opentree
 
 ### Architecture
 
-See [PLAN.md](PLAN.md) for detailed architecture documentation.
+`cmd/opentree` is the CLI surface; `pkg/` is where the work happens.
+
+| package | what it owns |
+| --- | --- |
+| `tui` | the dashboard: the workspace list, the Skills and Servers tabs |
+| `chat` | the conversation view, and the control socket the dashboard reaches it through |
+| `acp` | the Agent Client Protocol client — the agent subprocess and its stdio |
+| `workspace` | a workspace's lifecycle, over the four below it |
+| `worktree` | git worktrees and branches |
+| `tmux` | sessions and windows |
+| `state` | `state.json`, shared between the dashboard and every chat |
+| `github` | `gh`, for PRs, issues and CI status |
+| `bootstrap` | seeding a worktree, running its setup, and the trust gate over those commands |
+| `skills` | propagating agent skills into worktrees |
+| `config` | `opentree.toml` and the agent registry |
+| `notify`, `diag`, `ui`, `fsutil`, `gitutil` | the small shared pieces |
 
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.
 
+## Trademarks
+
+opentree draws each agent it drives — opencode, Claude Code, GitHub Copilot and Gemini CLI — under that agent's own wordmark and brand colour, so you can see at a glance which one you are talking to. Those marks belong to their respective owners. opentree is an independent project and is not affiliated with, sponsored by or endorsed by any of them. See [NOTICE](NOTICE).
+
 ## Acknowledgments
 
 - Inspired by [Conductor.build](https://conductor.build) by Sahil Lavingia

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axelgar/opentree",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Git worktree manager CLI for orchestrating parallel AI coding sessions",
   "repository": {
     "type": "git",
@@ -12,13 +12,15 @@
     "opentree": "bin/opentree"
   },
   "files": [
-    "bin/opentree"
+    "bin/opentree",
+    "LICENSE",
+    "NOTICE"
   ],
   "optionalDependencies": {
-    "@axelgar/opentree-linux-x64": "1.0.2",
-    "@axelgar/opentree-linux-arm64": "1.0.2",
-    "@axelgar/opentree-darwin-x64": "1.0.2",
-    "@axelgar/opentree-darwin-arm64": "1.0.2"
+    "@axelgar/opentree-linux-x64": "1.1.0",
+    "@axelgar/opentree-linux-arm64": "1.1.0",
+    "@axelgar/opentree-darwin-x64": "1.1.0",
+    "@axelgar/opentree-darwin-arm64": "1.1.0"
   },
   "engines": {
     "node": ">=18"