@axelgar/opentree 1.0.1 → 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

@@ -26,7 +26,7 @@ opentree is a cross-platform CLI tool that manages multiple AI coding agent sess
 ## Requirements
 
 - **Git** (2.5+) - for worktree support
-- **tmux** (3.0+) - for session orchestration
+- **tmux** (3.0+) - for session orchestration (3.2+ to type `shift+enter` in the chat)
 - **A coding agent** (optional) - OpenCode (the default), Claude Code, GitHub Copilot CLI or Gemini CLI
 - **GitHub CLI** (`gh`) (optional) - for PR creation and issue fetching ([install](https://cli.github.com/))
 - **Node** (optional) - only to run Claude Code through its ACP adapter
@@ -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
@@ -187,7 +197,8 @@ agent's own logo, in its own colours:
 | Key | |
 | --- | --- |
 | `enter` | send |
-| `ctrl+j` | newline |
+| `shift+enter` | newline — `ctrl+j` where the terminal cannot report modifiers |
+| `↑` / `↓` | walk back through the messages already sent, and forward again |
 | `/` | slash commands — the agent's own, plus `/resume`, `/login`, `/model` and the rest |
 | `@` | attach a file from this worktree |
 | `ctrl+v` | paste — an image on the clipboard is attached, anything else is text |
@@ -197,6 +208,20 @@ agent's own logo, in its own colours:
 | `ctrl+o` | show or hide the agent's reasoning |
 | `?` | every key |
 
+**Newlines.** `shift+enter` breaks the line instead of sending it, with nothing
+to configure. A terminal left to itself sends a bare carriage return for
+`shift+enter` — the same byte `enter` sends, and nothing downstream can tell the
+two apart — so the chat asks it for modified keys on the way in (xterm's
+`modifyOtherKeys`, level 1, put back on the way out), and sets `extended-keys`
+on its own tmux session so tmux passes them through. That is the whole reason
+the key works here and not in every terminal program.
+
+Level 1 is the conservative request: only keys that had no encoding of their own
+gain one, so `esc`, `ctrl+j` and the arrows are the bytes they always were, and a
+window running something else is untouched — tmux only forwards modified keys to
+programs that ask for them. In a terminal that cannot report modifiers at all
+(Terminal.app), `ctrl+j` and `alt+enter` still do it.
+
 **Images.** Press `ctrl+v` to attach a screenshot from the clipboard, or drag one
 onto the terminal. Either way the path collapses into `[image · shot.png · 412 KB]`
 in the message you are writing — backspace over it and the attachment goes with
@@ -206,6 +231,12 @@ terminal asked to paste a picture sends nothing at all. An agent that does not
 take images gets the path as a link instead, and the chat says so rather than
 letting the difference go unnoticed.
 
+**Messages you already sent.** `↑` puts the last one back in the box, `↓` walks
+forward again, and coming back past the newest returns whatever was half typed
+when you started looking — so a prompt worth repeating, or repeating with one
+word changed, is a keypress away rather than a retype. Inside a message the
+arrows still move the cursor: they only recall from its first and last row.
+
 **Earlier conversations.** `/resume` lists what this worktree has already
 talked about — newest first, by what each conversation was about — and picking
 one reopens it in place, history and all. The list is the agent's own where it
@@ -227,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
@@ -618,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.
@@ -690,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.1",
+  "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.1",
-    "@axelgar/opentree-linux-arm64": "1.0.1",
-    "@axelgar/opentree-darwin-x64": "1.0.1",
-    "@axelgar/opentree-darwin-arm64": "1.0.1"
+    "@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"