@zecalis/fael 0.13.0 → 0.14.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 +12 -5
- package/npm-shrinkwrap.json +2 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -5,14 +5,15 @@
|
|
|
5
5
|
[](https://github.com/zecalis/fael/actions/workflows/ci.yml)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
|
-
**The secretary for every agent on your team.** Every agent on your repo
|
|
9
|
-
what's still open —
|
|
8
|
+
**The secretary for every agent on your team.** Every agent on your repo gets what git can't tell
|
|
9
|
+
it — why a call was made, what was rejected, what's still open — next to the file it opens.
|
|
10
10
|
|
|
11
11
|
One person runs five agents; a team runs fifty — and each of those hands work to sub-agents. Every
|
|
12
12
|
one of them starts from zero: it finds the same flaky test, re-asks why that function looks weird,
|
|
13
13
|
and repeats the mistake the last agent already fixed.
|
|
14
14
|
Memory tools that try to help stuff a summary of everything into context before the agent has said
|
|
15
|
-
what it's about to do —
|
|
15
|
+
what it's about to do — the one row that mattered gets averaged away, and a summary of stale notes
|
|
16
|
+
is still stale.
|
|
16
17
|
|
|
17
18
|
fael works the other way round: like a good secretary, it takes the notes nobody else will and hands
|
|
18
19
|
each agent **only what matters for the file in front of it**. The agent writes down what it decided
|
|
@@ -35,6 +36,10 @@ fael gives the repo a memory that agents can't skip:
|
|
|
35
36
|
session after compaction, is told again — it no longer has them), and cut to a token budget
|
|
36
37
|
(800 by default) — not a notes dump. Anything else the agent asks for itself, through MCP.
|
|
37
38
|
`fael stats` shows exactly what fael has put into context.
|
|
39
|
+
- **It retires what the code outgrew.** Git owns what changed; fael keeps only what git can't say.
|
|
40
|
+
When an agent edits a file, it is asked to close a row the code now says, or re-file one the
|
|
41
|
+
code contradicts — in the same message. `fael doctor` lists the rest: open rows whose files took
|
|
42
|
+
10+ commits since they were written, to check against the code.
|
|
38
43
|
- **It follows the code.** Rename a file and its rows follow it (`git log -M`). Split one into
|
|
39
44
|
several and `fael mv old new` points the rows at the new files.
|
|
40
45
|
- **It lives in your git, out of your branches.** Rows are plain JSONL in the clone's `.git/fael/`,
|
|
@@ -60,7 +65,6 @@ Works with **Claude Code, Codex and OpenCode**, and any MCP host. One small bina
|
|
|
60
65
|
**1. Get the binary** — prebuilt for macOS, Linux and Windows. No Rust needed.
|
|
61
66
|
|
|
62
67
|
```bash
|
|
63
|
-
npm i -g @zecalis/fael # Node
|
|
64
68
|
brew install zecalis/tap/fael # Homebrew (macOS / Linux)
|
|
65
69
|
curl -LsSf https://github.com/zecalis/fael/releases/latest/download/fael-installer.sh | sh
|
|
66
70
|
```
|
|
@@ -71,6 +75,9 @@ Windows (PowerShell):
|
|
|
71
75
|
irm https://github.com/zecalis/fael/releases/latest/download/fael-installer.ps1 | iex
|
|
72
76
|
```
|
|
73
77
|
|
|
78
|
+
Or through npm: `npm i -g @zecalis/fael`. It works, but every `fael` call — including each hook —
|
|
79
|
+
starts Node first, so the options above are faster.
|
|
80
|
+
|
|
74
81
|
**2. Connect your agents** — once per machine.
|
|
75
82
|
|
|
76
83
|
```bash
|
|
@@ -122,8 +129,8 @@ fael doctor # check the setup (e.g.
|
|
|
122
129
|
|
|
123
130
|
## Links
|
|
124
131
|
|
|
125
|
-
- **npm:** [@zecalis/fael](https://www.npmjs.com/package/@zecalis/fael)
|
|
126
132
|
- **Homebrew tap:** [zecalis/homebrew-tap](https://github.com/zecalis/homebrew-tap)
|
|
133
|
+
- **npm:** [@zecalis/fael](https://www.npmjs.com/package/@zecalis/fael)
|
|
127
134
|
- **Releases & changelog:** [GitHub Releases](https://github.com/zecalis/fael/releases)
|
|
128
135
|
- **Bugs & ideas:** [Issues](https://github.com/zecalis/fael/issues)
|
|
129
136
|
- **Docs:** [architecture](docs/architecture.md) · [log format](docs/format.md) (read/write it without fael) · [integrate another agent](docs/integrate.md)
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"hasInstallScript": true,
|
|
20
20
|
"license": "MIT",
|
|
21
21
|
"name": "@zecalis/fael",
|
|
22
|
-
"version": "0.
|
|
22
|
+
"version": "0.14.0"
|
|
23
23
|
},
|
|
24
24
|
"node_modules/detect-libc": {
|
|
25
25
|
"engines": {
|
|
@@ -48,5 +48,5 @@
|
|
|
48
48
|
}
|
|
49
49
|
},
|
|
50
50
|
"requires": true,
|
|
51
|
-
"version": "0.
|
|
51
|
+
"version": "0.14.0"
|
|
52
52
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"artifactDownloadUrls": [
|
|
3
|
-
"https://github.com/zecalis/fael/releases/download/v0.
|
|
3
|
+
"https://github.com/zecalis/fael/releases/download/v0.14.0"
|
|
4
4
|
],
|
|
5
5
|
"bin": {
|
|
6
6
|
"fael": "run-fael.js"
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
"zipExt": ".tar.xz"
|
|
82
82
|
}
|
|
83
83
|
},
|
|
84
|
-
"version": "0.
|
|
84
|
+
"version": "0.14.0",
|
|
85
85
|
"volta": {
|
|
86
86
|
"node": "18.14.1",
|
|
87
87
|
"npm": "9.5.0"
|