@chorded/chord 0.59.0 → 0.63.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -10
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -29,7 +29,7 @@ take on your next task.
|
|
|
29
29
|
|
|
30
30
|
```sh
|
|
31
31
|
npm install -g @chorded/chord
|
|
32
|
-
chord #
|
|
32
|
+
chord # choose an agent, here
|
|
33
33
|
chord codex # or any other agent
|
|
34
34
|
```
|
|
35
35
|
|
|
@@ -69,8 +69,7 @@ ctrl+x a moves into the box to answer. `shift+tab` cycles permission modes.
|
|
|
69
69
|
### Agents beside the main one
|
|
70
70
|
|
|
71
71
|
`/new [agent]` opens an idle agent beside main and goes to it. The list
|
|
72
|
-
under the prompt shows agents and teams, their
|
|
73
|
-
unseen news.
|
|
72
|
+
under the prompt shows agents and teams, their state and unseen news.
|
|
74
73
|
`ctrl+x a` takes you to what waits.
|
|
75
74
|
|
|
76
75
|
<img src="docs/images/agents.png" alt="The agents list, with docs waiting on a permission" width="900">
|
|
@@ -90,7 +89,12 @@ work or a monitor's command and latest output; `x` stops where offered.
|
|
|
90
89
|
|
|
91
90
|
Describe how you work and the agent proposes a team: a lead and its members,
|
|
92
91
|
each on the runtime, model and mode you want. Save it once, then hand it any
|
|
93
|
-
job with `/team run bugfix <job
|
|
92
|
+
job with `/team run bugfix <job>` using its saved composition. In conversation,
|
|
93
|
+
its instructions can ask the launching agent to consider advisory resource facts
|
|
94
|
+
and select supported settings for that run,
|
|
95
|
+
leaving the saved team unchanged. Automatic quota readers initially support
|
|
96
|
+
Apple silicon Macs with specific Codex/Claude versions; see
|
|
97
|
+
[the guide](docs/guide.md#resource-facts-and-team-selection) for their limits.
|
|
94
98
|
|
|
95
99
|
<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">
|
|
96
100
|
|
|
@@ -116,7 +120,7 @@ chord starts each agent for you (through `npx` or `uvx`, or the agent's own
|
|
|
116
120
|
CLI where it has one), so the agent's own login is all it needs: sign in to
|
|
117
121
|
Claude Code, Codex or Gemini as you normally would.
|
|
118
122
|
|
|
119
|
-
To build from source, with [Bun](https://bun.sh) 1.4.
|
|
123
|
+
To build from source, with [Bun](https://bun.sh) 1.4.4 or newer:
|
|
120
124
|
|
|
121
125
|
```sh
|
|
122
126
|
git clone https://github.com/IKatsuba/chord && cd chord
|
|
@@ -127,9 +131,9 @@ bun dev compile --install # into ~/.local/bin/chord
|
|
|
127
131
|
## Use
|
|
128
132
|
|
|
129
133
|
```sh
|
|
130
|
-
chord #
|
|
134
|
+
chord # choose an agent in this directory
|
|
131
135
|
chord gemini -C ~/src/app
|
|
132
|
-
chord agents #
|
|
136
|
+
chord agents # agents, startup commands and own CLI availability
|
|
133
137
|
chord --continue # the latest session here, again
|
|
134
138
|
chord --resume <id> # a recorded session, on its own agent
|
|
135
139
|
chord --resume # pick an earlier session
|
|
@@ -137,24 +141,30 @@ chord -p "Explain src/main.tsx" # one reply on stdout, for scripts
|
|
|
137
141
|
git diff | chord -p "Review this" --output-format json
|
|
138
142
|
```
|
|
139
143
|
|
|
140
|
-
Inside the window
|
|
144
|
+
Inside the window, completion lists, history search and `?` appear above
|
|
145
|
+
the prompt; status and agents stay below:
|
|
141
146
|
|
|
142
147
|
| Key | Does |
|
|
143
148
|
| ----------------- | -------------------------------------------- |
|
|
144
149
|
| `?` | every key, on an empty prompt |
|
|
145
150
|
| `/` | slash commands, chord's and the agent's |
|
|
146
151
|
| `@` | mention a file |
|
|
152
|
+
| `@@` | complete an agent's name |
|
|
147
153
|
| `!` | run a shell command, its output for the agent |
|
|
148
154
|
| `alt+←` / `alt+→` | move by word in the prompt |
|
|
149
155
|
| `cmd+←` / `cmd+→` | line start/end, where the terminal passes it |
|
|
156
|
+
| `tab` | send into the running turn, where supported |
|
|
150
157
|
| `shift+tab` | cycle the permission mode |
|
|
151
158
|
| `ctrl+o` | expand Read output and subagents |
|
|
152
159
|
| `ctrl+x a` | go to what waits on you |
|
|
160
|
+
| `ctrl+x b` | pick code; `c` copies, `r` puts in the prompt |
|
|
153
161
|
| `esc` | interrupt the turn |
|
|
154
162
|
|
|
155
163
|
Settings live in `~/.config/chord/settings.json` and the project's
|
|
156
|
-
`.chord/settings.json`: the default agent
|
|
157
|
-
mode, MCP servers, theme
|
|
164
|
+
`.chord/settings.json`: the default agent (initially highlighted in the
|
|
165
|
+
startup picker), each agent's model, effort and mode, MCP servers, theme
|
|
166
|
+
and notifications. Each new unnamed interactive start asks again; the pick
|
|
167
|
+
applies to that run and is not saved.
|
|
158
168
|
|
|
159
169
|
**[The guide](docs/guide.md)** has everything else: every flag, setting, key,
|
|
160
170
|
the team file format, chord's MCP tools for agents, and how sessions are
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chorded/chord",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.63.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
"bin/"
|
|
29
29
|
],
|
|
30
30
|
"optionalDependencies": {
|
|
31
|
-
"@chorded/chord-darwin-arm64": "0.
|
|
32
|
-
"@chorded/chord-darwin-x64": "0.
|
|
33
|
-
"@chorded/chord-linux-x64": "0.
|
|
34
|
-
"@chorded/chord-linux-arm64": "0.
|
|
31
|
+
"@chorded/chord-darwin-arm64": "0.63.0",
|
|
32
|
+
"@chorded/chord-darwin-x64": "0.63.0",
|
|
33
|
+
"@chorded/chord-linux-x64": "0.63.0",
|
|
34
|
+
"@chorded/chord-linux-arm64": "0.63.0"
|
|
35
35
|
}
|
|
36
36
|
}
|