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.
- package/README.md +52 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,29 +1,40 @@
|
|
|
1
|
-
# aegiscode — the terminal
|
|
1
|
+
# aegiscode — the assistant in your terminal
|
|
2
2
|
|
|
3
|
-
`aegiscode`
|
|
4
|
-
|
|
5
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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** —
|
|
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
|
|
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 —
|
|
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` `/
|
|
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
|
|
267
|
-
|
|
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
|
-
|
|
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.
|
|
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",
|