@unerr-ai/unerr 0.0.0-beta.10 → 0.0.0-beta.12
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 +53 -35
- package/dist/cli.js +2538 -1022
- package/dist/ui/screenshots/activity.png +0 -0
- package/dist/ui/screenshots/code-base-intelligence.png +0 -0
- package/dist/ui/screenshots/dashboard.png +0 -0
- package/dist/ui/screenshots/project-memory.png +0 -0
- package/dist/ui/screenshots/reasoning-quality.png +0 -0
- package/dist/ui/screenshots/token-trace-main.png +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="https://unerr.dev/icon-wordmark.svg" alt="unerr" width="320"
|
|
2
|
+
<a href="https://www.unerr.dev/"><img src="https://unerr.dev/icon-wordmark.svg" alt="unerr — local intelligence layer for AI coding agents" width="320" /></a>
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
@@ -12,7 +12,11 @@
|
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
14
|
<p align="center">
|
|
15
|
+
<a href="https://www.unerr.dev/"><img src="https://img.shields.io/badge/website-unerr.dev-8B5CF6?style=flat-square&logo=icloud&logoColor=white" alt="Website" /></a>
|
|
15
16
|
<a href="https://www.npmjs.com/package/@unerr-ai/unerr"><img src="https://img.shields.io/badge/install-npm_i_@unerr--ai/unerr-8B5CF6?style=flat-square&logo=npm" alt="Install" /></a>
|
|
17
|
+
<a href="https://discord.gg/JfZ4pYgb"><img src="https://img.shields.io/badge/community-Discord-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" /></a>
|
|
18
|
+
<a href="https://x.com/unerr_ai"><img src="https://img.shields.io/badge/follow-@unerr__ai-000000?style=flat-square&logo=x&logoColor=white" alt="X / Twitter" /></a>
|
|
19
|
+
<a href="https://www.linkedin.com/company/unerr"><img src="https://img.shields.io/badge/linkedin-unerr-0A66C2?style=flat-square&logo=linkedin&logoColor=white" alt="LinkedIn" /></a>
|
|
16
20
|
<img src="https://img.shields.io/badge/runtime-Node.js_≥20-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js" />
|
|
17
21
|
<img src="https://img.shields.io/badge/protocol-MCP-7C3AED?style=flat-square" alt="MCP" />
|
|
18
22
|
<img src="https://img.shields.io/badge/local--first-no_cloud-22D3EE?style=flat-square" alt="Local-first" />
|
|
@@ -53,40 +57,54 @@ The agent reads from the same store through MCP — every claim on the dashboard
|
|
|
53
57
|
|
|
54
58
|
### See it in action
|
|
55
59
|
|
|
56
|
-
<
|
|
57
|
-
<
|
|
58
|
-
<
|
|
59
|
-
<
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
<
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
<
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
<
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
</
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
</
|
|
83
|
-
</
|
|
84
|
-
|
|
85
|
-
|
|
60
|
+
<table align="center">
|
|
61
|
+
<tr>
|
|
62
|
+
<td align="center" width="240">
|
|
63
|
+
<img src="https://unerr.dev/open-cli/screenshots/dashboard.png" alt="unerr dashboard — live overview" width="240" height="150" />
|
|
64
|
+
<br/><sub><strong>Dashboard</strong><br/>Live overview — active sessions, recent tool calls, tokens saved this turn.</sub>
|
|
65
|
+
</td>
|
|
66
|
+
<td align="center" width="240">
|
|
67
|
+
<img src="https://unerr.dev/open-cli/screenshots/token-trace-main.png" alt="unerr token trace — global" width="240" height="150" />
|
|
68
|
+
<br/><sub><strong>Token Trace · global</strong><br/>Aggregate savings across every session, broken down by mechanism (graph, file_read, shell, dedup, format).</sub>
|
|
69
|
+
</td>
|
|
70
|
+
<td align="center" width="240">
|
|
71
|
+
<img src="https://unerr.dev/open-cli/screenshots/token-session.png" alt="unerr token trace — session" width="240" height="150" />
|
|
72
|
+
<br/><sub><strong>Token Trace · session</strong><br/>Single session: per-turn savings, mechanism mix, and the compounding multiplier.</sub>
|
|
73
|
+
</td>
|
|
74
|
+
<td align="center" width="240">
|
|
75
|
+
<img src="https://unerr.dev/open-cli/screenshots/token-turn.png" alt="unerr token trace — turn" width="240" height="150" />
|
|
76
|
+
<br/><sub><strong>Token Trace · turn</strong><br/>Single turn: which tool calls fired, tokens each would have cost without unerr vs what was delivered.</sub>
|
|
77
|
+
</td>
|
|
78
|
+
</tr>
|
|
79
|
+
<tr>
|
|
80
|
+
<td align="center" width="240">
|
|
81
|
+
<img src="https://unerr.dev/open-cli/screenshots/reasoning-quality.png" alt="unerr reasoning quality — global" width="240" height="150" />
|
|
82
|
+
<br/><sub><strong>Reasoning Quality · global</strong><br/>Four-pillar score across cleaner context, fewer wasted turns, fewer breakages, persistent memory.</sub>
|
|
83
|
+
</td>
|
|
84
|
+
<td align="center" width="240">
|
|
85
|
+
<img src="https://unerr.dev/open-cli/screenshots/reasoning-session.png" alt="unerr reasoning quality — session" width="240" height="150" />
|
|
86
|
+
<br/><sub><strong>Reasoning Quality · session</strong><br/>Per-session: which facts and conventions were reinforced, acted on, ignored, or corrected.</sub>
|
|
87
|
+
</td>
|
|
88
|
+
<td align="center" width="240">
|
|
89
|
+
<img src="https://unerr.dev/open-cli/screenshots/code-base-intelligence.png" alt="unerr code intelligence" width="240" height="150" />
|
|
90
|
+
<br/><sub><strong>Code Intelligence</strong><br/>Call graph, fan-in/out chokepoints, cross-module surprise links, and a risk grade per file.</sub>
|
|
91
|
+
</td>
|
|
92
|
+
<td align="center" width="240">
|
|
93
|
+
<img src="https://unerr.dev/open-cli/screenshots/project-memory.png" alt="unerr project memory — facts" width="240" height="150" />
|
|
94
|
+
<br/><sub><strong>Project Memory</strong><br/>Conventions, anti-patterns, decisions — with decay-adjusted confidence and reinforcement counts.</sub>
|
|
95
|
+
</td>
|
|
96
|
+
</tr>
|
|
97
|
+
<tr>
|
|
98
|
+
<td align="center" width="240" colspan="4">
|
|
99
|
+
<img src="https://unerr.dev/open-cli/screenshots/activity.png" alt="unerr activity — timeline + heatmap" width="240" height="150" />
|
|
100
|
+
<br/><sub><strong>Activity</strong><br/>Turn-grouped timeline with a 30-day heatmap — each row is one burst of agent work (intent → tools → outcome).</sub>
|
|
101
|
+
</td>
|
|
102
|
+
</tr>
|
|
103
|
+
</table>
|
|
86
104
|
|
|
87
105
|
---
|
|
88
106
|
|
|
89
|
-
## Quick Start
|
|
107
|
+
## Quick Start
|
|
90
108
|
|
|
91
109
|
> unerr is **per-repository**. Each project gets its own `.unerr/` directory, graph DB, and config. Run install once per repo.
|
|
92
110
|
|
|
@@ -119,7 +137,7 @@ unerr install gemini-cli # → .gemini/settings.json + GEMINI.md + .gemi
|
|
|
119
137
|
unerr install github-copilot-cli # → .copilot/mcp-config.json + .github/copilot-instructions.md + .github/skills/
|
|
120
138
|
```
|
|
121
139
|
|
|
122
|
-
What
|
|
140
|
+
What it does:
|
|
123
141
|
|
|
124
142
|
1. Writes a project-level MCP config (`{"command": "unerr", "args": ["--mcp"]}`) — never global.
|
|
125
143
|
2. Drops 11 bundled skills into the agent's skills directory so the agent knows when to call which tool.
|
|
@@ -128,7 +146,7 @@ What this actually does, in order:
|
|
|
128
146
|
5. Adds `.unerr` to `.gitignore`.
|
|
129
147
|
6. For Claude Code, denies built-in `Read`/`Grep`/`Glob` so the agent must use unerr's graph-aware equivalents (opt out with `--no-force-tools`).
|
|
130
148
|
|
|
131
|
-
> Need a different agent or doing it by hand? `unerr install --show-instructions <agent>` prints copy-pasteable setup.
|
|
149
|
+
> Need a different agent or doing it by hand? `unerr install --show-instructions <agent>` prints copy-pasteable setup.
|
|
132
150
|
|
|
133
151
|
### 4. Run `unerr` — and **keep it running**
|
|
134
152
|
|
|
@@ -390,5 +408,5 @@ See [CLAUDE.md](./CLAUDE.md) for full conventions.
|
|
|
390
408
|
<p align="center">
|
|
391
409
|
<code>npm install -g @unerr-ai/unerr</code>
|
|
392
410
|
<br /><br />
|
|
393
|
-
<a href="https://www.npmjs.com/package/@unerr-ai/unerr"><sub>npm registry</sub></a> · <sub>Fully local. No account. No cloud. Free.</sub>
|
|
411
|
+
<a href="https://www.unerr.dev/"><sub>unerr.dev</sub></a> · <a href="https://www.npmjs.com/package/@unerr-ai/unerr"><sub>npm registry</sub></a> · <a href="https://discord.gg/2BjRftz8kG"><sub>Discord</sub></a> · <a href="https://x.com/unerr_ai"><sub>X</sub></a> · <a href="https://www.linkedin.com/company/unerr"><sub>LinkedIn</sub></a> · <sub>Fully local. No account. No cloud. Free.</sub>
|
|
394
412
|
</p>
|