astracode-agent 0.1.0 → 0.3.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 CHANGED
@@ -14,6 +14,12 @@ It works on macOS and Linux, on arm64 and x64. It checks the download's
14
14
  checksum, and on a Mac also checks that AstraCode signed it. To update, run
15
15
  `astracode-agent update`, which runs the same installer for the latest version.
16
16
 
17
+ With Homebrew, on macOS or Linux:
18
+
19
+ ```bash
20
+ brew install vrx-astracode/tap/astracode-agent
21
+ ```
22
+
17
23
  With Node 20 or later you can also install it from npm:
18
24
 
19
25
  ```bash
@@ -46,6 +52,55 @@ export ASTRACODE_API_KEY=ac_live_...
46
52
  A key takes precedence over a saved session. A key can have its own spending
47
53
  limit, and you can revoke it without signing anyone out.
48
54
 
55
+ ## A conversation
56
+
57
+ ```bash
58
+ astracode-agent
59
+ astracode-agent "why does the login test fail?"
60
+ astracode-agent --continue # pick up this folder's last conversation
61
+ astracode-agent --resume # choose an earlier one
62
+ ```
63
+
64
+ On its own, `astracode-agent` opens a conversation with the agent in the
65
+ current folder. A request on the command line is the first message.
66
+
67
+ - **Asking before it acts.** Before an edit or a command it asks: Yes, Yes and
68
+ don't ask again this session, or No and tell it what to do instead.
69
+ **Shift-Tab** cycles three modes: **ask**, **auto** (edits and commands run
70
+ without asking, though risky ones still ask) and **plan** (it reads and
71
+ writes a plan, then offers to build it).
72
+ - **Steering.** **Esc** stops a run and keeps what it has done so far. A
73
+ message typed while it works reaches it at its next step.
74
+ - **Typing.** `\` Enter, Ctrl-J or Option-Enter adds a new line. Up and Down
75
+ go through history, and Ctrl-R searches it. `@` mentions a file, and `/`
76
+ opens the commands. Ctrl-G opens the message in `$EDITOR`, and Ctrl-V
77
+ pastes an image on macOS.
78
+ - **Output.** Replies stream as they arrive. Each tool call is one line and
79
+ each edit is shown as a diff. Ctrl-O shows full tool output, and Ctrl-T
80
+ shows or hides the todo list. The footer shows the mode, the model and how
81
+ much of the context is used.
82
+ - **Shortcuts.** `!command` runs in your shell, and its output goes with your
83
+ next message. `# note` remembers something about this project.
84
+
85
+ Commands:
86
+
87
+ | command | |
88
+ |---|---|
89
+ | `/clear`, `/resume` | start a new conversation, or go back to one |
90
+ | `/undo`, `/rewind` | take back the last message, or go back to before an earlier one, restoring its edits too |
91
+ | `/compact`, `/context` | summarise the conversation to free context, or see how much is used |
92
+ | `/model` | AstraOne: balanced, most capable, or lowest cost |
93
+ | `/plan` | switch to plan mode |
94
+ | `/memory` | what it remembers about the project |
95
+ | `/init` | write an `AGENTS.md` |
96
+ | `/review`, `/diff` | review this branch, or see uncommitted changes |
97
+ | `/tasks`, `/mcp` | background commands and MCP servers |
98
+ | `/export`, `/status`, `/help` | save the conversation, account and model details, all keys |
99
+
100
+ Your own commands and skills from `.astracode/commands` and
101
+ `.astracode/skills` appear in the `/` menu too. MCP servers go under
102
+ `"mcp.servers"` in `~/.config/astracode/settings.json`.
103
+
49
104
  ## Running a task
50
105
 
51
106
  ```
@@ -81,7 +136,7 @@ changed.
81
136
 
82
137
  - **`text`**: stdout is the agent's final answer, and nothing else.
83
138
  - **`json`**: stdout is one object, with `ok`, `end`, `summary`,
84
- `filesChanged`, `denied`, `steps`, `costUsd` and `durationMs`.
139
+ `filesChanged`, `denied`, `steps` and `durationMs`.
85
140
  - **`stream-json`**: one JSON object per line, one for each agent event
86
141
  (tool calls, tool results, text, todos), then the same result object.
87
142
 
@@ -112,7 +167,50 @@ apology in the summary.
112
167
  Let the agent make the edits, and let the workflow's own steps commit, push and
113
168
  comment. The agent refuses `git push` under `auto` for that reason.
114
169
 
115
- ## What is different from the editor
170
+ ## In Zed or a JetBrains IDE
171
+
172
+ `astracode-agent acp` speaks the [Agent Client Protocol](https://agentclientprotocol.com),
173
+ so editors that run external agents can use AstraCode as their agent. You sign
174
+ in the same way as on the command line, and usage is billed to your AstraCode
175
+ account.
176
+
177
+ **Zed**: add this to `settings.json`, then pick AstraCode in the agent panel:
178
+
179
+ ```json
180
+ {
181
+ "agent_servers": {
182
+ "AstraCode": {
183
+ "type": "custom",
184
+ "command": "astracode-agent",
185
+ "args": ["acp"]
186
+ }
187
+ }
188
+ }
189
+ ```
190
+
191
+ **JetBrains**: in the AI Chat tool window, choose **Add Custom Agent**, and put
192
+ this in the `~/.jetbrains/acp.json` file it opens:
193
+
194
+ ```json
195
+ {
196
+ "agent_servers": {
197
+ "AstraCode": {
198
+ "command": "/Users/you/.local/bin/astracode-agent",
199
+ "args": ["acp"]
200
+ }
201
+ }
202
+ }
203
+ ```
204
+
205
+ Use the full path that `which astracode-agent` prints. If you are not signed in
206
+ yet, the editor offers to sign you in the first time you use AstraCode.
207
+
208
+ The editor shows each edit as a diff and asks before the agent changes a file
209
+ or runs a command. **Always allow** applies to that tool for the rest of the
210
+ session. Risky commands and requests to other machines are asked about every
211
+ time.
212
+
213
+
116
214
 
117
215
  These are not available without an editor:
118
216