aegiscode 7.0.42 → 7.0.43

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.
Files changed (2) hide show
  1. package/README.md +52 -23
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,29 +1,40 @@
1
- # aegiscode — the terminal host
1
+ # aegiscode — the assistant in your terminal
2
2
 
3
- `aegiscode` in your shell — the command-line version of AEGIS One. The same
4
- tool surface the Claude Code plugin exposes over MCP, plus a terminal instead of
5
- an editor — built on the same two shared pieces and no others:
3
+ `aegiscode` is the command-line version of AEGIS One. You type what you want in
4
+ plain English — *"why does the build fail?"*, *"rename this function
5
+ throughout"*, *"summarise what changed this week"* — and it reads your files,
6
+ runs commands, edits code and answers. It is the same assistant, in a terminal
7
+ window instead of a window with buttons.
6
8
 
7
- | Shared piece | What it is |
8
- |---|---|
9
- | `client/aegis.js` | The thin transport. Holds the API key, speaks HTTP/SSE. No brain logic. |
10
- | `mcp/tools.js` | The tool registry — names, JSON schemas, result formatting. |
11
- | `desktop/renderer/usage.js` | The token-usage → number mapping, shared with the GUI so the two can never disagree. |
12
- | `desktop/lib/local/` | The agent-loop engine — persistent-shell exec, read/write/edit/glob/grep, Task subagents. The CLI runs the same loop the GUI does, scoped to the AEGIS class. |
9
+ There is nothing to configure before you start and no project to set up.
13
10
 
14
- Routing, model tiers, memory and billing all stay behind aegiscloud.org.
11
+ **You need two things:**
12
+
13
+ 1. **[Node.js 22 or newer](https://nodejs.org/en/download)** — the runtime that
14
+ runs the app. On macOS or Windows the installer is a double-click; on Linux
15
+ use your package manager. Check yours with `node -v`.
16
+ 2. **A free AEGIS key** from <https://aegiscloud.org> — this is what lets it
17
+ think. You paste it once, in step 2 below.
18
+
19
+ If you have never used a terminal before: it is the plain window where you type
20
+ commands and press Enter. On macOS it is called **Terminal**; on Windows,
21
+ **PowerShell**. Open it and type the grey boxes below exactly as written.
15
22
 
16
23
  ## Quick start
17
24
 
18
25
  Four steps, in order. Everything past this section is the fuller reference for
19
26
  each one.
20
27
 
21
- **1. Install** — requires Node 22+.
28
+ **1. Install** — needs Node 22+ (see above if you are not sure).
22
29
 
23
30
  ```bash
24
31
  npm install -g aegiscode
25
32
  ```
26
33
 
34
+ `npm` comes with Node.js. `-g` means *"install this so I can run it from any
35
+ folder"*. This one line downloads the app and puts the `aegiscode` command on
36
+ your machine.
37
+
27
38
  **2. Log in** — get a key at <https://aegiscloud.org> if you don't have one.
28
39
 
29
40
  ```bash
@@ -56,7 +67,7 @@ product, so they are one name now:
56
67
 
57
68
  | Name | Status |
58
69
  |---|---|
59
- | `aegiscode` | **this host**, v6.0.0. Installs a single binary, `aegiscode`. |
70
+ | `aegiscode` | **this host**. Installs a single command, `aegiscode`. Run `aegiscode version` for the version you have. |
60
71
  | `aegis-terminal` | deprecated — the 0.1.x spelling of this package, folded into `aegiscode`. |
61
72
  | `aegiscode-cli` | 4.0.3, an earlier name of this CLI's predecessor line. Untouched. |
62
73
  | `aegis-cli` | 0.4.8 (unrelated). |
@@ -249,22 +260,28 @@ launch, and an explicit flag (`-m`, `--light`) always outranks the stored value.
249
260
 
250
261
  In a session, plain text is a prompt. `/help` lists commands, grouped by
251
262
  category, the way the reference does. The registry is that client's, ported
252
- command for command — 87 entries across nine categories:
263
+ command for command — 96 entries across eight categories:
253
264
 
254
265
  | Category | Commands |
255
266
  |---|---|
256
- | Session & context | `/schedule` `/clear` `/compact` `/context` `/todos` `/config` `/exit` `/recap` `/resume` `/rewind` `/agents` `/status` `/teleport` `/version` `/new` `/skills` `/multiyolo` `/multi` `/research` `/debate` |
257
- | Workspace | `/run` `/build` `/cd` `/init` `/clone` |
258
- | Model & behavior | `/ping` `/effort` `/model` `/models` `/model-add` `/model-rm` `/theme` `/terminal` `/vim` `/permissions` `/hooks` `/credentials` `/install-github-app` `/thinking` `/mcp` `/memory` `/memory-deep` `/confirm` `/automode` *(alias `/yolo`)* `/router` `/class` |
259
- | Data | `/copy` `/cost` `/export` `/tokens` `/sync` |
260
- | Auth | `/login` `/logout` `/key` `/byok` `/byok-set` `/byok-rm` `/byok-key` `/byok-rm-key` |
261
- | Support | `/help` `/doctor` `/upgrade` `/troubleshooting` `/feedback` `/bug` `/issue` `/onboarding` `/shell-completion` `/terminal-setup` `/pr-comments` `/prs` `/review` `/benchmark` `/billing` `/topup` `/cloud` `/gmail` `/release-notes` |
267
+ | Session & context | `/schedule` `/clear` `/undo` `/compact` `/context` `/todos` `/config` `/exit` `/recap` `/resume` `/rewind` `/agents` `/status` `/teleport` `/version` `/new` `/skills` `/multiyolo` `/multi` `/research` `/debate` |
268
+ | Workspace | `/run` `/build` `/cd` `/sandbox` `/init` `/clone` |
269
+ | Model & behavior | `/ping` `/effort` `/model` `/theme` `/terminal` `/vim` `/permissions` `/hooks` `/credentials` `/install-github-app` `/thinking` `/mcp` `/memory` `/memory-deep` `/confirm` `/automode` *(alias `/yolo`)* `/router` `/class` `/models` `/model-add` `/model-discover` `/model-rm` |
270
+ | Data | `/copy` `/cost` `/export` `/tokens` `/sync` `/drive` |
271
+ | Auth | `/login` `/logout` `/key` `/byok` `/byok-set` `/byok-rm` `/byok-list` `/byok-key` `/byok-rm-key` |
272
+ | Support | `/help` `/license` `/credits` `/doctor` `/upgrade` `/troubleshooting` `/feedback` `/bug` `/issue` `/onboarding` `/shell-completion` `/terminal-setup` `/pr-comments` `/prs` `/review` `/benchmark` `/billing` `/topup` `/cloud` `/gmail` `/release-notes` |
262
273
  | Fun | `/radio` `/waifu` |
263
274
  | Aegis plugin | `/aegis-status` `/aegis-ask` `/aegis-recall` `/aegis-remember` `/aegis-council` `/aegis-print` `/aegis-multi` `/tool` `/aegis-import` |
264
275
 
276
+ There are 96 commands in eight categories; the ninth category in the registry,
277
+ `Custom`, holds none by default. `/yolo` is an **alias** of `/automode`, not a
278
+ command of its own — it never appears as its own row.
279
+
265
280
  The table above is generated from `cli/src/commands.js` (`COMMANDS` +
266
- `CATEGORIES`), which is the only authority on what exists — a hand-kept copy is
267
- how it came to claim 75 entries while the code held 84 before this port.
281
+ `CATEGORIES`), which is the only authority on what exists, and
282
+ `test/readme-claims.test.mjs` asserts that every name here matches the registry
283
+ exactly. A hand-kept copy is how it came to claim 75 entries while the code held
284
+ 84 before this port.
268
285
 
269
286
  `/help` shows the live list with hints; aliases are searchable in the `/`
270
287
  palette exactly as they are there (`/ask` → `/aegis-ask`, `?` → `/help`,
@@ -647,7 +664,7 @@ alternate-screen frame of header rule, transcript viewport, spinner/effort line,
647
664
  input line and status line, driven by a raw key stream.
648
665
 
649
666
  ```
650
- ╭───────────────────────────── AEGIS Code v6.3.0 ─────────────────────────────╮
667
+ ╭────────────────────────── AEGIS Code v<version> ────────────────────────────╮
651
668
  ❯ summarise what changed in the token accounting
652
669
  ● Three things changed, and one of them was costing you money:
653
670
 
@@ -717,6 +734,18 @@ node cli/scripts/demo.mjs # from a source checkout
717
734
 
718
735
  ## Design notes
719
736
 
737
+ **Four shared pieces, and no others.** The CLI is not a second implementation;
738
+ it is the same parts the other faces use:
739
+
740
+ | Shared piece | What it is |
741
+ |---|---|
742
+ | `client/aegis.js` | The thin transport. Holds the API key, speaks HTTP/SSE. No brain logic. |
743
+ | `mcp/tools.js` | The tool registry — names, JSON schemas, result formatting. |
744
+ | `desktop/renderer/usage.js` | The token-usage → number mapping, shared with the GUI so the two can never disagree. |
745
+ | `desktop/lib/local/` | The agent-loop engine — persistent-shell exec, read/write/edit/glob/grep, Task subagents. The CLI runs the same loop the GUI does, scoped to the AEGIS class. |
746
+
747
+ Routing, model tiers, memory and billing all stay behind aegiscloud.org.
748
+
720
749
  **It looks like the reference on purpose.** The gold/coral/lavender palette,
721
750
  the `✦`-studded welcome mark (mascot, crescent moon and diving whale), the `❯`
722
751
  prompt, the `⎿` hook rows and the `✻` spinner line are the reference's
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "aegiscode",
3
3
  "productName": "AEGIS Code",
4
- "version": "7.0.42",
4
+ "version": "7.0.43",
5
5
  "description": "aegiscode — the command-line version of AEGIS One. The shared tool surface in your shell, over the same thin transport and tool registry as the MCP plugin and the desktop app. Ships transport + UI only; no brain.",
6
6
  "author": {
7
7
  "name": "AEGIS Code",