@chorded/chord 0.0.0-stage → 0.54.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Katsuba
+
+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/README.md

@@ -1,3 +1,174 @@
-# Temporary Holding Version
+<h1 align="center">chord</h1>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <strong>One terminal for every coding agent.</strong><br>
+  Claude Code, Codex, Gemini CLI, Cursor, OpenCode and 30 more, in one
+  keyboard-driven window, side by side, working as a team.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@chorded/chord"><img alt="npm" src="https://img.shields.io/npm/v/@chorded/chord?color=47e7a5&label=npm"></a>
+  <a href="https://github.com/IKatsuba/chord/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/IKatsuba/chord/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="MIT licence" src="https://img.shields.io/badge/licence-MIT-blue"></a>
+  <img alt="macOS and Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey">
+</p>
+
+<p align="center">
+  <img src="docs/images/team.png" alt="chord handing an issue to a team: a lead, a tester on Claude and a coder on Codex, each with its state in the list under the prompt" width="900">
+</p>
+
+Claude Code's terminal interface is the best one there is for working with a
+coding agent, and it only talks to Claude. chord is that interface for any
+agent that speaks the [Agent Client Protocol](https://agentclientprotocol.com):
+the same transcript, diffs, permission prompts, slash commands, `@` mentions
+and plans, on whichever agent you start, and more than one of them at once.
+
+```sh
+npm install -g @chorded/chord
+chord            # Claude Code, here
+chord codex      # or any other agent
+```
+
+## Why chord
+
+- **Any agent, one interface.** 35 agents out of the box, from the
+  [ACP Registry](https://agentclientprotocol.com) and their own CLIs. Switch
+  agents without relearning keys.
+- **Agents that work together.** Open a second agent beside the one you talk
+  to, hand a job to a saved team, and watch each of them in a list under the
+  prompt. Messages go between them; permissions still come to you.
+- **Every action has a key.** Nothing on screen needs a mouse. `?` lists them
+  all, and a keybindings file moves them.
+- **Nothing to set up.** One binary, no account, no daemon. chord starts the
+  agent, keeps the session, and gives it back with `chord --continue`.
+- **Open source.** MIT, built on [OpenTUI](https://github.com/anomalyco/opentui)
+  and the [ACP SDK](https://github.com/agentclientprotocol/typescript-sdk).
+
+## A tour
+
+### Diffs you can read
+
+Edits arrive as numbered, highlighted diffs, folded until you want the whole
+thing (`ctrl+o`).
+
+<img src="docs/images/edit.png" alt="An Edit tool call drawn as a coloured diff" width="900">
+
+### You stay in charge
+
+Each permission the agent asks for is a choice under the transcript, answered
+with a number or the arrows. `shift+tab` cycles the agent's permission modes.
+
+<img src="docs/images/permission.png" alt="The permission prompt: Allow, Always allow, Deny" width="900">
+
+### Many agents in one window
+
+Up to nine sessions as tabs, each with its own agent, transcript and draft.
+A tab in the background marks what it waits for, and `ctrl+x a` takes you
+there.
+
+<img src="docs/images/tabs.png" alt="Two tabs, claude waiting on a permission behind, codex in front" width="900">
+
+### Subagents, folded
+
+When the agent fans out, its subagents run as one tree with their latest call
+each, and their full work is a key away.
+
+<img src="docs/images/subagents.png" alt="Two subagents running in parallel under one block" width="900">
+
+### Teams
+
+Describe how you work and the agent proposes a team: a lead and its members,
+each on the runtime, model and mode you want. Save it once, then hand it any
+job with `/team run bugfix <job>`.
+
+<img src="docs/images/proposal.png" alt="A proposed team as a table of agents, with a box asking where to save it" width="900">
+
+### Pick up where you left off
+
+`/resume` lists this directory's earlier sessions and saved windows; quit a
+window of several tabs and chord prints the one command that brings them all
+back.
+
+<img src="docs/images/resume.png" alt="The resume picker listing earlier sessions" width="900">
+
+## Install
+
+```sh
+npm install -g @chorded/chord   # or bun, pnpm, yarn
+```
+
+The package is a small shim around a prebuilt binary for macOS and Linux,
+arm64 and x64; the macOS binaries are signed and notarised. `chord upgrade`
+updates it through the package manager that installed it.
+
+chord starts each agent for you (through `npx` or `uvx`, or the agent's own
+CLI where it has one), so the agent's own login is all it needs: sign in to
+Claude Code, Codex or Gemini as you normally would.
+
+To build from source, with [Bun](https://bun.sh) 1.4.2 or newer:
+
+```sh
+git clone https://github.com/IKatsuba/chord && cd chord
+bun install
+bun run compile --install   # into ~/.local/bin/chord
+```
+
+## Use
+
+```sh
+chord                  # your default agent in this directory
+chord gemini -C ~/src/app
+chord agents           # every agent chord can start, and whether it is installed
+chord --continue       # the latest session here, again
+chord --resume         # pick an earlier session or window
+chord -p "Explain src/main.tsx"          # one reply on stdout, for scripts
+git diff | chord -p "Review this" --output-format json
+```
+
+Inside the window:
+
+| Key               | Does                                         |
+| ----------------- | -------------------------------------------- |
+| `?`               | every key, on an empty prompt                |
+| `/`               | slash commands, chord's and the agent's      |
+| `@`               | mention a file                               |
+| `!`               | run a shell command, its output for the agent |
+| `shift+tab`       | cycle the permission mode                    |
+| `ctrl+o`          | expand tool calls and subagents              |
+| `ctrl+x c` / `/new codex` | open another session as a tab        |
+| `ctrl+x 1`…`9`    | go to a tab                                  |
+| `esc`             | interrupt the turn                           |
+
+Settings live in `~/.config/chord/settings.json` and the project's
+`.chord/settings.json`: the default agent, each agent's model, effort and
+mode, MCP servers, theme and notifications.
+
+**[The guide](docs/guide.md)** has everything else: every flag, setting, key,
+the team file format, chord's MCP tools for agents, and how sessions are
+recorded.
+
+## Supported agents
+
+Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, OpenCode, Cline, Qwen
+Code, Kimi Code, Kiro, Goose, Junie, Factory Droid, Auggie, Kilo, Devin, fx
+and more: `chord agents` prints the full list, and any other ACP agent runs
+with `chord --agent-command "my-agent --acp"`.
+
+## Contributing
+
+Issues and pull requests are welcome. [CONTRIBUTING.md](CONTRIBUTING.md) has
+how to run chord from source against its scripted test agent, the one check
+every change passes, and how the code is written. Found a security issue?
+See [SECURITY.md](SECURITY.md).
+
+The screenshots above are chord itself, run against that test agent and
+captured by `bun run screenshots`.
+
+## Licence
+
+chord's code is [MIT](LICENSE). The Chorded name and the chevron mark are
+trademarks of Igor Katsuba and are not covered by the licence; a fork should
+draw its own ([TRADEMARKS.md](TRADEMARKS.md)).
+
+chord is the open sibling of [Chorded](https://chorded.app), a native macOS
+workspace for agent sessions driven by key chords.

package/bin/chord.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// The `chord` command npm installs: it runs the binary of this machine's
+// platform package with the same arguments and stdio, and leaves as the
+// binary left. A Node script, because npm runs `bin` with the user's Node
+// and the user need not have Bun.
+const { spawn } = require("node:child_process");
+
+const pkg = `@chorded/chord-${process.platform}-${process.arch}`;
+let bin;
+try {
+  bin = require.resolve(`${pkg}/bin/chord`);
+} catch {
+  process.stderr.write(
+    `chord: no ${pkg} is installed. chord runs on macOS and Linux, arm64 and x64; reinstall @chorded/chord on one of those, with optional dependencies.\n`,
+  );
+  process.exit(1);
+}
+
+// spawn, not spawnSync: a blocked event loop cannot forward a signal, and a
+// SIGTERM to this process alone would leave the binary running.
+const child = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
+const forwarded = ["SIGINT", "SIGTERM", "SIGHUP"];
+for (const signal of forwarded) {
+  process.on(signal, () => child.kill(signal));
+}
+child.on("error", (error) => {
+  process.stderr.write(`chord: ${bin} did not start: ${error.message}\n`);
+  process.exit(1);
+});
+child.on("exit", (status, signal) => {
+  if (signal) {
+    // Re-raise the child's signal, so a chord ended by one still ends by it
+    // as the shell sees it; the handlers go first, or they would catch it.
+    for (const name of forwarded) process.removeAllListeners(name);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(status ?? 1);
+});

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@chorded/chord",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.54.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IKatsuba/chord.git"
+  },
+  "homepage": "https://github.com/IKatsuba/chord#readme",
+  "bugs": {
+    "url": "https://github.com/IKatsuba/chord/issues"
+  },
+  "description": "A full-screen terminal client for ACP coding agents.",
+  "keywords": [
+    "acp",
+    "agent-client-protocol",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "coding-agent",
+    "terminal",
+    "tui"
+  ],
+  "bin": {
+    "chord": "bin/chord.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "optionalDependencies": {
+    "@chorded/chord-darwin-arm64": "0.54.1",
+    "@chorded/chord-darwin-x64": "0.54.1",
+    "@chorded/chord-linux-x64": "0.54.1",
+    "@chorded/chord-linux-arm64": "0.54.1"
+  }
+}