liteagents 2.5.2 → 2.6.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/CHANGELOG.md +76 -15
- package/README.md +58 -30
- package/docs/INSTALLATION_DEMO.md +1 -1
- package/docs/INSTALLATION_LOCATIONS.md +5 -5
- package/docs/INSTALLER_GUIDE.md +5 -5
- package/docs/KNOWLEDGE_BASE.md +5 -5
- package/docs/MIGRATION.md +1 -1
- package/docs/PASS_QUICK_START.md +1 -1
- package/docs/PRIVACY.md +1 -1
- package/docs/PUBLISHING.md +7 -7
- package/docs/RELEASE_NOTES_1.2.0.md +2 -2
- package/docs/SILENT_MODE_GUIDE.md +1 -1
- package/installer/cli.js +1 -1
- package/installer/installation-engine.js +82 -21
- package/installer/package-manager.js +34 -3
- package/package.json +7 -6
- package/packages/ampcode/AGENT.md +1 -0
- package/packages/ampcode/commands/friction/friction.js +19 -4
- package/packages/ampcode/commands/live-canvas/DESIGN_PRINCIPLES.md +2140 -0
- package/packages/ampcode/commands/live-canvas/README.md +273 -0
- package/packages/ampcode/commands/live-canvas/templates/.claude/settings.local.json +8 -0
- package/packages/ampcode/commands/live-canvas/templates/demo/post-variants.html +205 -0
- package/packages/ampcode/commands/live-canvas/templates/feedback-react/FeedbackOverlay.tsx +1299 -0
- package/packages/ampcode/commands/live-canvas/templates/feedback-react/format-utils.ts +283 -0
- package/packages/ampcode/commands/live-canvas/templates/feedback-react/index.ts +62 -0
- package/packages/ampcode/commands/live-canvas/templates/feedback-react/selector-utils.ts +423 -0
- package/packages/ampcode/commands/live-canvas/templates/feedback-react/types.ts +118 -0
- package/packages/ampcode/commands/live-canvas/templates/overlay-vanilla.js +477 -0
- package/packages/ampcode/commands/live-canvas.md +1104 -0
- package/packages/claude/CLAUDE.md +1 -0
- package/packages/claude/commands/friction/friction.js +19 -4
- package/packages/claude/plugins/live-canvas-marketplace/.claude-plugin/marketplace.json +14 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/.claude-plugin/plugin.json +18 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/README.md +89 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/package-lock.json +1142 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/package.json +17 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/schema.json +37 -0
- package/packages/claude/plugins/live-canvas-marketplace/plugins/live-canvas-channel/server.js +179 -0
- package/packages/claude/plugins/live-canvas-marketplace/setup.sh +61 -0
- package/packages/claude/skills/live-canvas/DESIGN_PRINCIPLES.md +2140 -0
- package/packages/claude/skills/live-canvas/INTEGRATION_NOTES.md +210 -0
- package/packages/claude/skills/live-canvas/README.md +273 -0
- package/packages/claude/skills/live-canvas/SKILL.md +1119 -0
- package/packages/claude/skills/live-canvas/templates/.claude/settings.local.json +8 -0
- package/packages/claude/skills/live-canvas/templates/demo/post-variants.html +205 -0
- package/packages/claude/skills/live-canvas/templates/feedback-react/FeedbackOverlay.tsx +1299 -0
- package/packages/claude/skills/live-canvas/templates/feedback-react/format-utils.ts +283 -0
- package/packages/claude/skills/live-canvas/templates/feedback-react/index.ts +62 -0
- package/packages/claude/skills/live-canvas/templates/feedback-react/selector-utils.ts +423 -0
- package/packages/claude/skills/live-canvas/templates/feedback-react/types.ts +118 -0
- package/packages/claude/skills/live-canvas/templates/overlay-vanilla.js +477 -0
- package/packages/claude/variants.json +2 -1
- package/packages/droid/AGENTS.md +1 -0
- package/packages/droid/commands/friction/friction.js +19 -4
- package/packages/droid/commands/live-canvas/DESIGN_PRINCIPLES.md +2140 -0
- package/packages/droid/commands/live-canvas/README.md +273 -0
- package/packages/droid/commands/live-canvas/templates/.claude/settings.local.json +8 -0
- package/packages/droid/commands/live-canvas/templates/demo/post-variants.html +205 -0
- package/packages/droid/commands/live-canvas/templates/feedback-react/FeedbackOverlay.tsx +1299 -0
- package/packages/droid/commands/live-canvas/templates/feedback-react/format-utils.ts +283 -0
- package/packages/droid/commands/live-canvas/templates/feedback-react/index.ts +62 -0
- package/packages/droid/commands/live-canvas/templates/feedback-react/selector-utils.ts +423 -0
- package/packages/droid/commands/live-canvas/templates/feedback-react/types.ts +118 -0
- package/packages/droid/commands/live-canvas/templates/overlay-vanilla.js +477 -0
- package/packages/droid/commands/live-canvas.md +1104 -0
- package/packages/opencode/AGENTS.md +1 -0
- package/packages/opencode/command/friction/friction.js +19 -4
- package/packages/opencode/command/live-canvas/DESIGN_PRINCIPLES.md +2140 -0
- package/packages/opencode/command/live-canvas/README.md +273 -0
- package/packages/opencode/command/live-canvas/templates/.claude/settings.local.json +8 -0
- package/packages/opencode/command/live-canvas/templates/demo/post-variants.html +205 -0
- package/packages/opencode/command/live-canvas/templates/feedback-react/FeedbackOverlay.tsx +1299 -0
- package/packages/opencode/command/live-canvas/templates/feedback-react/format-utils.ts +283 -0
- package/packages/opencode/command/live-canvas/templates/feedback-react/index.ts +62 -0
- package/packages/opencode/command/live-canvas/templates/feedback-react/selector-utils.ts +423 -0
- package/packages/opencode/command/live-canvas/templates/feedback-react/types.ts +118 -0
- package/packages/opencode/command/live-canvas/templates/overlay-vanilla.js +477 -0
- package/packages/opencode/command/live-canvas.md +1104 -0
- package/packages/opencode/opencode.jsonc +4 -0
- package/packages/subagentic-manual.md +18 -15
package/CHANGELOG.md
CHANGED
|
@@ -17,6 +17,67 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
+
## [2.6.0] - 2026-04-19
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
- **live-canvas skill** — Design interview, generates 5 UI variations, collects click-to-annotate feedback from the browser, produces a final implementation plan. Available as a skill in Claude Code and as a command in Droid/Ampcode/Opencode.
|
|
24
|
+
- **Vanilla overlay** (`overlay-vanilla.js`, ~400 lines, zero deps) — framework-agnostic click-to-annotate HUD with pin placement, selector inference (`data-testid` > `id` > class chain, CSS-in-JS hashes filtered), variant detection via `data-variant` attribute, and a v1.0 schema wire-compatible with the upstream React template.
|
|
25
|
+
- **React overlay** (`FeedbackOverlay.tsx`) kept for React/Next/Vite projects.
|
|
26
|
+
- **Demo** (`templates/demo/post-variants.html`) — standalone 5-variant post card playground for review without starting a dev server.
|
|
27
|
+
- **Handholding activation flow** — Phase 0 probes the channel on every invocation and offers `AskUserQuestion` choices: first-time users get the full 4-step setup; returning users who forgot the dev flag get the restart command; channel-up sessions proceed silently.
|
|
28
|
+
- **live-canvas-channel plugin** (Claude Code only) — MCP channel server that bridges the overlay's HTTP POSTs into the live session as `notifications/claude/channel` events. Packaged as a Claude Code marketplace under `packages/claude/plugins/live-canvas-marketplace/`.
|
|
29
|
+
- HTTP listener on `127.0.0.1:8788` with `/health` probe and `/feedback` POST endpoint
|
|
30
|
+
- MCP server using `@modelcontextprotocol/sdk` with `experimental: {'claude/channel': {}}` capability
|
|
31
|
+
- `instructions` field added to tell Claude how to act on incoming `<channel source="live-canvas">` tags: acknowledge in chat → locate variant file → edit → confirm
|
|
32
|
+
- `setup.sh` helper that runs `npm install` and prints the 3 remaining manual steps
|
|
33
|
+
- **Installer: plugins as first-class category** — `packages/<tool>/plugins/` now discovered, selected per variant, and copied to `<target>/plugins/`, parallel to skills. `node_modules/` excluded during copy and size computation. Manifest generation includes a `plugins` component count, installed-files list, and path entry.
|
|
34
|
+
- **Friction report: project attribution in cluster output** — `antigen_review.md` now shows which projects each cluster spans (new "Projects" column in the summary table; new `**Projects:**` line per cluster). Data was always in `session_id`; the previous version dropped it during clustering.
|
|
35
|
+
|
|
36
|
+
### Changed
|
|
37
|
+
- **README restructured for Hot Memory visibility** — new top-level `🧠 Hot Memory` section between Quick Start and What's Included, with pipeline diagram and sample friction output. Manual Skills/Commands list regrouped into named sub-sections (Hot Memory Pipeline, Design, Workflow & analysis). Old duplicated Hot Memory section removed.
|
|
38
|
+
- **Command/skill count 22 → 23** per tool across README, subagentic-manual, and per-package `AGENTS.md` / `AGENT.md` / `CLAUDE.md`.
|
|
39
|
+
- **opencode.jsonc** — added `live-canvas` entry under `"command"` block.
|
|
40
|
+
|
|
41
|
+
### Fixed
|
|
42
|
+
- **Friction clustering dropped project names** — cluster object converted `{sessionId: true}` dict to a count before rendering, so `antigen_review.md` never surfaced which repos contributed to each pattern. Fix preserves `session_ids[]` and `projects[]` on every cluster.
|
|
43
|
+
- **Live Canvas overlay counter flicker in live mode** — counter went 0→1→0 during successful push roundtrip. Rewrote so successful live pushes never enter the pending-batch state; counter stays at 0 unless a push actually fails.
|
|
44
|
+
|
|
45
|
+
### Notes
|
|
46
|
+
- The Claude Code channel plugin is subject to Claude Code's research preview: custom channels require `--dangerously-load-development-channels` at session start, and steps 2-4 of setup (`/plugin marketplace add`, `/plugin install`, session restart) cannot be automated. The skill prints copyable commands and an alias suggestion.
|
|
47
|
+
- Droid, Ampcode, and Opencode run live-canvas in batch mode only — channels are Claude-Code-specific.
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## [2.5.2] - 2026-02-11
|
|
52
|
+
|
|
53
|
+
### Added
|
|
54
|
+
- **friction command** — Analyze session logs for failure patterns, behavioral signals, and antigen clusters
|
|
55
|
+
- 14 weighted signals (user_intervention, false_success, tool_loop, etc.)
|
|
56
|
+
- Session scoring and quality classification (BAD/FRICTION/ROUGH/OK)
|
|
57
|
+
- Candidate clustering by (anchor_signal, tool_sequence) for 3-4x compression
|
|
58
|
+
- Context noise filtering and dedup in clusters
|
|
59
|
+
- Bundled `friction.js` (2157 lines) with absolute search paths per platform
|
|
60
|
+
- **remember command** — Consolidate stashes and friction output into persistent project memory
|
|
61
|
+
- Extracts facts and episodes from session stashes via sonnet
|
|
62
|
+
- Distills friction clusters into behavioral preferences with confidence tiers
|
|
63
|
+
- Writes unified `.claude/memory/MEMORY.md` (or platform equivalent)
|
|
64
|
+
- Injects `@MEMORY.md` reference into instruction file (CLAUDE.md/AGENTS.md/AGENT.md)
|
|
65
|
+
- **Hot Memory pipeline** — Lightweight session memory: `/stash` -> `/friction` -> `/remember`
|
|
66
|
+
- Documented in README and subagentic-manual
|
|
67
|
+
- **Platform-specific paths** across all 4 packages (claude, droid, opencode, ampcode)
|
|
68
|
+
- Each package uses correct instruction file, project path, and global install path
|
|
69
|
+
- **.gitignore** — Added `.claude/`, `.factory/`, `.opencode/`, `.amp/` project data directories
|
|
70
|
+
|
|
71
|
+
### Changed
|
|
72
|
+
- **context-builder** — Updated per platform with correct instruction file, project/global paths, tool name, and `@MEMORY.md` discovery
|
|
73
|
+
- **docs-builder** — Synced blueprint.md section and templates across all packages
|
|
74
|
+
- **opencode.jsonc** — Registered friction and remember commands
|
|
75
|
+
- **AGENTS.md/AGENT.md** — Command counts updated 10 -> 12 across all packages
|
|
76
|
+
- **package.json** — Description updated to 22 commands
|
|
77
|
+
- **installer banner** — Updated to v2.5.2 with 22 commands
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
20
81
|
## [2.4.7] - 2026-02-02
|
|
21
82
|
|
|
22
83
|
### Changed
|
|
@@ -33,12 +94,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
33
94
|
## [2.4.1] - 2026-01-24
|
|
34
95
|
|
|
35
96
|
### Changed - Package Rebranding
|
|
36
|
-
- **BREAKING:** Package renamed from `@
|
|
97
|
+
- **BREAKING:** Package renamed from `@hamr0/agentic-kit` to `liteagents` (unscoped)
|
|
37
98
|
- Better reflects lightweight, CLI-focused nature
|
|
38
99
|
- Easier installation: `npm install -g liteagents`
|
|
39
100
|
- Commands: `liteagents` and `liteag` (shorthand)
|
|
40
101
|
- **Repository:** Renamed from `agentic-kit` to `liteagents` on GitHub
|
|
41
|
-
- New URL: https://github.com/
|
|
102
|
+
- New URL: https://github.com/hamr0/liteagents
|
|
42
103
|
- Old URLs redirect automatically
|
|
43
104
|
|
|
44
105
|
### Removed
|
|
@@ -59,10 +120,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
59
120
|
- `docs/PUBLISHING.md` simplified to focus on npm
|
|
60
121
|
|
|
61
122
|
### Migration Guide
|
|
62
|
-
For users of `@
|
|
123
|
+
For users of `@hamr0/agentic-kit`:
|
|
63
124
|
```bash
|
|
64
125
|
# Uninstall old package
|
|
65
|
-
npm uninstall -g @
|
|
126
|
+
npm uninstall -g @hamr0/agentic-kit
|
|
66
127
|
|
|
67
128
|
# Install new package
|
|
68
129
|
npm install -g liteagents
|
|
@@ -71,7 +132,7 @@ npm install -g liteagents
|
|
|
71
132
|
liteagents # or 'liteag' for shorthand
|
|
72
133
|
```
|
|
73
134
|
|
|
74
|
-
Old package `@
|
|
135
|
+
Old package `@hamr0/agentic-kit` will be deprecated with migration message.
|
|
75
136
|
|
|
76
137
|
---
|
|
77
138
|
|
|
@@ -346,8 +407,8 @@ Old package `@amrhas82/agentic-kit` will be deprecated with migration message.
|
|
|
346
407
|
|
|
347
408
|
### Fixed
|
|
348
409
|
- Skill count - Corrected Pro variant from 16 to 14 skills
|
|
349
|
-
- Repository URLs - Updated to `github.com/
|
|
350
|
-
- Author info - Updated to `
|
|
410
|
+
- Repository URLs - Updated to `github.com/hamr0/liteagents`
|
|
411
|
+
- Author info - Updated to `hamr0 <avoidaccess@msn.com>`
|
|
351
412
|
- All variant manifests - Added session-start hook
|
|
352
413
|
|
|
353
414
|
### Removed
|
|
@@ -366,8 +427,8 @@ Old package `@amrhas82/agentic-kit` will be deprecated with migration message.
|
|
|
366
427
|
|
|
367
428
|
**Distribution:**
|
|
368
429
|
- npm package: `liteagents`
|
|
369
|
-
- GitHub: `github.com/
|
|
370
|
-
- Direct install: `/plugin add github:
|
|
430
|
+
- GitHub: `github.com/hamr0/liteagents`
|
|
431
|
+
- Direct install: `/plugin add github:hamr0/liteagents`
|
|
371
432
|
- npx support: `npx liteagents` or `npx agkit`
|
|
372
433
|
|
|
373
434
|
**Infrastructure:**
|
|
@@ -425,7 +486,7 @@ liteagents
|
|
|
425
486
|
**To Upgrade:**
|
|
426
487
|
```bash
|
|
427
488
|
# Via GitHub
|
|
428
|
-
/plugin update github:
|
|
489
|
+
/plugin update github:hamr0/liteagents
|
|
429
490
|
|
|
430
491
|
# Via npm
|
|
431
492
|
npm update liteagents
|
|
@@ -461,7 +522,7 @@ liteagents install
|
|
|
461
522
|
**To Upgrade:**
|
|
462
523
|
```bash
|
|
463
524
|
# Via GitHub
|
|
464
|
-
/plugin update github:
|
|
525
|
+
/plugin update github:hamr0/liteagents
|
|
465
526
|
|
|
466
527
|
# Via npm
|
|
467
528
|
npm update liteagents
|
|
@@ -489,12 +550,12 @@ npx liteagents
|
|
|
489
550
|
|
|
490
551
|
## Links
|
|
491
552
|
|
|
492
|
-
- **GitHub**: https://github.com/
|
|
553
|
+
- **GitHub**: https://github.com/hamr0/liteagents
|
|
493
554
|
- **npm**: https://www.npmjs.com/package/liteagents
|
|
494
|
-
- **Issues**: https://github.com/
|
|
495
|
-
- **Releases**: https://github.com/
|
|
555
|
+
- **Issues**: https://github.com/hamr0/liteagents/issues
|
|
556
|
+
- **Releases**: https://github.com/hamr0/liteagents/releases
|
|
496
557
|
|
|
497
558
|
---
|
|
498
559
|
|
|
499
|
-
**Maintained by**:
|
|
560
|
+
**Maintained by**: hamr0
|
|
500
561
|
**License**: MIT
|
package/README.md
CHANGED
|
@@ -9,16 +9,16 @@
|
|
|
9
9
|
╚══════╝╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚══════╝
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
**AI development toolkit with 11 specialized agents and
|
|
12
|
+
**AI development toolkit with 11 specialized agents and 23 commands per tool**
|
|
13
13
|
|
|
14
14
|
[](https://www.npmjs.com/package/liteagents)
|
|
15
15
|
[](https://opensource.org/licenses/MIT)
|
|
16
16
|
|
|
17
17
|
**Supported Tools:**
|
|
18
18
|
[](https://claude.ai)
|
|
19
|
-
[](https://github.com/
|
|
20
|
-
[](https://github.com/
|
|
21
|
-
[](https://github.com/
|
|
19
|
+
[](https://github.com/hamr0/opencode)
|
|
20
|
+
[](https://github.com/hamr0/ampcode)
|
|
21
|
+
[](https://github.com/hamr0/droid)
|
|
22
22
|
|
|
23
23
|
</div>
|
|
24
24
|
|
|
@@ -43,10 +43,10 @@ liteagents
|
|
|
43
43
|
|
|
44
44
|
### Supported Tools
|
|
45
45
|
|
|
46
|
-
- **Claude Code** - 11 subagents +
|
|
47
|
-
- **Opencode** - 11 agent references +
|
|
48
|
-
- **Ampcode** - 11 subagents +
|
|
49
|
-
- **Droid** - 11 agent references +
|
|
46
|
+
- **Claude Code** - 11 subagents + 11 skills + 12 commands (+ optional live-canvas channel plugin)
|
|
47
|
+
- **Opencode** - 11 agent references + 23 commands
|
|
48
|
+
- **Ampcode** - 11 subagents + 23 commands
|
|
49
|
+
- **Droid** - 11 agent references + 23 commands
|
|
50
50
|
|
|
51
51
|
**Key Difference:**
|
|
52
52
|
- **Claude Code**: Full subagent system with orchestrator + skills (auto-triggering)
|
|
@@ -69,6 +69,39 @@ liteagents
|
|
|
69
69
|
|
|
70
70
|
---
|
|
71
71
|
|
|
72
|
+
## 🧠 Hot Memory — project-local learning from your own sessions
|
|
73
|
+
|
|
74
|
+
Liteagents ships a three-command pipeline that turns Claude Code's session logs into project-local memory. No databases, no external services, just markdown files the assistant reads via `@MEMORY.md`.
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
/stash → /friction → /remember
|
|
78
|
+
capture analyze consolidate
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
- **`/stash`** — snapshot the current session's context before compaction or handoff
|
|
82
|
+
- **`/friction`** — mine JSONL session logs for frustration signals, failed flows, and abandonment patterns; cluster them into antigen candidates per project
|
|
83
|
+
- **`/remember`** — consolidate stashes + friction antigens into `.claude/memory/MEMORY.md`; auto-injected into `CLAUDE.md` via `@MEMORY.md` so every future session in the project benefits
|
|
84
|
+
|
|
85
|
+
What you get is a memory that *learns from your own mistakes and interventions*, grows quietly in your repo, and works anywhere Claude Code runs. The friction analyzer alone scans all your projects and gives you a per-repo reliability verdict:
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
Per-Project:
|
|
89
|
+
my-app 56% BAD (40/72) median: 16.0 🔴
|
|
90
|
+
api-service 40% BAD (2/5) median: 0.5 🟡
|
|
91
|
+
web-client 0% BAD (0/1) median: 0.0 ✅
|
|
92
|
+
|
|
93
|
+
WORST: my-app/0203-1630-11eb903a peak=225 turns=127
|
|
94
|
+
BEST: web-client/0202-2121-8d8608e1 peak=0 turns=4
|
|
95
|
+
|
|
96
|
+
Verdict: ✓ USEFUL Intervention predictability: 93%
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Results land in `.claude/friction/antigen_review.md` with projects, error patterns, and offending tool sequences called out per cluster — so `/remember` can pick them up and encode them as rules the next session sees.
|
|
100
|
+
|
|
101
|
+
> This is the thing in liteagents that nothing else ships. Normal skill bundles give you instructions. The hot-memory pipeline gives you instructions the assistant wrote for itself, from your own logs.
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
72
105
|
## 🤖 What's Included
|
|
73
106
|
|
|
74
107
|
### 11 Agents
|
|
@@ -88,14 +121,24 @@ liteagents
|
|
|
88
121
|
- **system-architect** - System design, technology selection, API design, scalability planning
|
|
89
122
|
- **ui-designer** - UI/UX design, wireframes, prototypes, accessibility, design systems
|
|
90
123
|
|
|
91
|
-
###
|
|
124
|
+
### 23 Commands/Skills
|
|
92
125
|
|
|
93
126
|
**Auto-Triggering Skills (3)** - Claude Code only:
|
|
94
127
|
- **test-driven-development** - Write test first, watch fail, minimal passing code
|
|
95
128
|
- **testing-anti-patterns** - Prevent mocking anti-patterns
|
|
96
129
|
- **verification-before-completion** - Verify before claiming done
|
|
97
130
|
|
|
98
|
-
**Manual Skills/Commands (
|
|
131
|
+
**Manual Skills/Commands (20):**
|
|
132
|
+
|
|
133
|
+
*Hot Memory Pipeline (3)* — see the [🧠 Hot Memory](#-hot-memory--project-local-learning-from-your-own-sessions) section above for the full walkthrough:
|
|
134
|
+
- **stash** - Snapshot session context to `.claude/stash/` before compaction, handoff, or ending complex work
|
|
135
|
+
- **friction** - Analyze all JSONL sessions for frustration signals, cluster failures per project, surface antigens
|
|
136
|
+
- **remember** - Consolidate stashes + friction antigens into `.claude/memory/MEMORY.md`; auto-injected via `@MEMORY.md`
|
|
137
|
+
|
|
138
|
+
*Design*:
|
|
139
|
+
- **live-canvas** - Design UI variations with click-to-annotate feedback in the browser; ships a companion MCP channel plugin for Claude Code so Saves stream into the session in real time. Other tools use batch mode.
|
|
140
|
+
|
|
141
|
+
*Workflow & analysis*:
|
|
99
142
|
- **brainstorming** - Structured brainstorming sessions
|
|
100
143
|
- **code-review** - Implementation review against requirements
|
|
101
144
|
- **condition-based-waiting** - Replace timeouts with condition polling
|
|
@@ -105,30 +148,15 @@ liteagents
|
|
|
105
148
|
- **systematic-debugging** - Four-phase debugging framework
|
|
106
149
|
- **debug** - Systematic issue investigation
|
|
107
150
|
- **explain** - Explain code for newcomers
|
|
108
|
-
- **friction** - Analyze session logs for failure patterns and behavioral signals
|
|
109
151
|
- **git-commit** - Intelligent commit creation
|
|
110
152
|
- **optimize** - Performance analysis
|
|
111
153
|
- **refactor** - Safe refactoring with behavior preservation
|
|
112
|
-
- **remember** - Consolidate stashes + friction into project memory
|
|
113
154
|
- **review** - Comprehensive code review
|
|
114
155
|
- **security** - Vulnerability scanning
|
|
115
156
|
- **ship** - Pre-deployment checklist
|
|
116
|
-
- **stash** - Save session context for compaction recovery or handoffs
|
|
117
157
|
- **test-generate** - Generate test suites
|
|
118
158
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
Lightweight session memory that learns from your usage patterns.
|
|
122
|
-
|
|
123
|
-
```
|
|
124
|
-
/stash → /friction → /remember
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
1. **`/stash`** - Snapshot current session context to `.claude/stash/`. Use before compaction, handoffs, or ending complex work.
|
|
128
|
-
2. **`/friction`** - Analyze session logs for failure patterns. Scores sessions, clusters failures, outputs actionable antigens.
|
|
129
|
-
3. **`/remember`** - Consolidate stashes + friction into `.claude/memory/MEMORY.md`. Extracts facts, episodes, and behavioral preferences. Injects into CLAUDE.md via `@MEMORY.md`.
|
|
130
|
-
|
|
131
|
-
**Result:** Project-local memory that accumulates across sessions — no external dependencies, no databases, just markdown.
|
|
159
|
+
> **Claude-only plugin:** `live-canvas-channel` is a bundled Claude Code MCP channel plugin that ships under `~/.claude/plugins/live-canvas-marketplace/`. One-time `/plugin install` + a session started with `--dangerously-load-development-channels` unlocks live mode. Skill probes for the channel on each invocation and handholds setup when missing. See [`packages/claude/skills/live-canvas/README.md`](packages/claude/skills/live-canvas/README.md) for the full walkthrough.
|
|
132
160
|
|
|
133
161
|
---
|
|
134
162
|
|
|
@@ -183,15 +211,15 @@ Lightweight session memory that learns from your usage patterns.
|
|
|
183
211
|
## 🔗 Links
|
|
184
212
|
|
|
185
213
|
- **npm:** https://www.npmjs.com/package/liteagents
|
|
186
|
-
- **GitHub:** https://github.com/
|
|
187
|
-
- **Issues:** https://github.com/
|
|
214
|
+
- **GitHub:** https://github.com/hamr0/liteagents
|
|
215
|
+
- **Issues:** https://github.com/hamr0/liteagents/issues
|
|
188
216
|
|
|
189
217
|
---
|
|
190
218
|
|
|
191
219
|
## 📄 License
|
|
192
220
|
|
|
193
|
-
MIT © 2025
|
|
221
|
+
MIT © 2025 hamr0
|
|
194
222
|
|
|
195
223
|
---
|
|
196
224
|
|
|
197
|
-
**Need help?** Check [TROUBLESHOOTING.md](TROUBLESHOOTING.md) or [open an issue](https://github.com/
|
|
225
|
+
**Need help?** Check [TROUBLESHOOTING.md](TROUBLESHOOTING.md) or [open an issue](https://github.com/hamr0/liteagents/issues)
|
|
@@ -288,7 +288,7 @@ Next steps:
|
|
|
288
288
|
|
|
289
289
|
Documentation:
|
|
290
290
|
• Installation guide: /home/user/.claude/README.md
|
|
291
|
-
• Troubleshooting: https://github.com/
|
|
291
|
+
• Troubleshooting: https://github.com/hamr0/liteagents/docs/INSTALLER_GUIDE.md
|
|
292
292
|
|
|
293
293
|
Thank you for installing Agentic Kit!
|
|
294
294
|
```
|
|
@@ -10,12 +10,12 @@ This document explains **where** Agentic Kit files get installed depending on th
|
|
|
10
10
|
|
|
11
11
|
**Command:**
|
|
12
12
|
```bash
|
|
13
|
-
/plugin add github:
|
|
13
|
+
/plugin add github:hamr0/liteagents
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
**Install Location:**
|
|
17
17
|
```
|
|
18
|
-
~/.config/claude-code/plugins/github-
|
|
18
|
+
~/.config/claude-code/plugins/github-hamr0-liteagents/
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
**What's Installed:**
|
|
@@ -221,7 +221,7 @@ npm root -g
|
|
|
221
221
|
|
|
222
222
|
### Claude Code Plugin
|
|
223
223
|
```bash
|
|
224
|
-
/plugin remove github-
|
|
224
|
+
/plugin remove github-hamr0-liteagents
|
|
225
225
|
```
|
|
226
226
|
|
|
227
227
|
### npm Local
|
|
@@ -259,12 +259,12 @@ https://registry.npmjs.org/liteagents/-/liteagents-1.1.0.tgz
|
|
|
259
259
|
|
|
260
260
|
### GitHub Repository
|
|
261
261
|
```
|
|
262
|
-
https://github.com/
|
|
262
|
+
https://github.com/hamr0/liteagents
|
|
263
263
|
```
|
|
264
264
|
|
|
265
265
|
Claude Code clones from:
|
|
266
266
|
```
|
|
267
|
-
git clone https://github.com/
|
|
267
|
+
git clone https://github.com/hamr0/liteagents.git
|
|
268
268
|
```
|
|
269
269
|
|
|
270
270
|
---
|
package/docs/INSTALLER_GUIDE.md
CHANGED
|
@@ -1279,11 +1279,11 @@ cat ~/.liteagents-install.log
|
|
|
1279
1279
|
```
|
|
1280
1280
|
|
|
1281
1281
|
2. **File an issue**:
|
|
1282
|
-
- GitHub: https://github.com/
|
|
1282
|
+
- GitHub: https://github.com/hamr0/liteagents/issues
|
|
1283
1283
|
- Include: OS, Node.js version, error message, installation log
|
|
1284
1284
|
|
|
1285
1285
|
3. **Community support**:
|
|
1286
|
-
- Discussions: https://github.com/
|
|
1286
|
+
- Discussions: https://github.com/hamr0/liteagents/discussions
|
|
1287
1287
|
- Discord: [link if available]
|
|
1288
1288
|
|
|
1289
1289
|
---
|
|
@@ -1575,12 +1575,12 @@ liteagents install
|
|
|
1575
1575
|
Need help? Here's how to get support:
|
|
1576
1576
|
|
|
1577
1577
|
1. **Documentation**: Check this guide and related docs
|
|
1578
|
-
2. **Issues**: https://github.com/
|
|
1579
|
-
3. **Discussions**: https://github.com/
|
|
1578
|
+
2. **Issues**: https://github.com/hamr0/liteagents/issues
|
|
1579
|
+
3. **Discussions**: https://github.com/hamr0/liteagents/discussions
|
|
1580
1580
|
4. **Email**: support@liteagents.dev (if available)
|
|
1581
1581
|
|
|
1582
1582
|
---
|
|
1583
1583
|
|
|
1584
1584
|
**Last Updated**: 2025-11-04
|
|
1585
1585
|
**Installer Version**: 1.2.0
|
|
1586
|
-
**Maintainer**: @
|
|
1586
|
+
**Maintainer**: @hamr0
|
package/docs/KNOWLEDGE_BASE.md
CHANGED
|
@@ -569,7 +569,7 @@ Create your own marketplace catalog:
|
|
|
569
569
|
"plugins": [
|
|
570
570
|
{
|
|
571
571
|
"name": "liteagents-standard",
|
|
572
|
-
"source": "github:
|
|
572
|
+
"source": "github:hamr0/liteagents"
|
|
573
573
|
}
|
|
574
574
|
]
|
|
575
575
|
}
|
|
@@ -580,7 +580,7 @@ Create your own marketplace catalog:
|
|
|
580
580
|
Clone and link for development:
|
|
581
581
|
|
|
582
582
|
```bash
|
|
583
|
-
git clone https://github.com/
|
|
583
|
+
git clone https://github.com/hamr0/liteagents.git
|
|
584
584
|
cd liteagents
|
|
585
585
|
npm link
|
|
586
586
|
```
|
|
@@ -709,9 +709,9 @@ A: Agents are AI assistants with roles. Skills are executable tools agents can u
|
|
|
709
709
|
|
|
710
710
|
## Resources
|
|
711
711
|
|
|
712
|
-
- **GitHub:** https://github.com/
|
|
712
|
+
- **GitHub:** https://github.com/hamr0/liteagents
|
|
713
713
|
- **npm:** https://www.npmjs.com/package/liteagents
|
|
714
|
-
- **Issues:** https://github.com/
|
|
714
|
+
- **Issues:** https://github.com/hamr0/liteagents/issues
|
|
715
715
|
- **Detailed Docs:**
|
|
716
716
|
- [AGENTS.md](AGENTS.md) - Complete agent directory
|
|
717
717
|
- [SKILLS.md](SKILLS.md) - Complete skill reference
|
|
@@ -724,4 +724,4 @@ A: Agents are AI assistants with roles. Skills are executable tools agents can u
|
|
|
724
724
|
|
|
725
725
|
**Last Updated:** November 2025
|
|
726
726
|
**Version:** 1.1.0
|
|
727
|
-
**Maintainer:**
|
|
727
|
+
**Maintainer:** hamr0
|
package/docs/MIGRATION.md
CHANGED
|
@@ -365,7 +365,7 @@ After migrating, verify:
|
|
|
365
365
|
If you encounter issues during migration:
|
|
366
366
|
|
|
367
367
|
1. **Check Documentation**: Review this guide and INSTALLER_GUIDE.md
|
|
368
|
-
2. **GitHub Issues**: https://github.com/
|
|
368
|
+
2. **GitHub Issues**: https://github.com/hamr0/liteagents/issues
|
|
369
369
|
3. **Debug Mode**: Run with `DEBUG=* node installer/cli.js`
|
|
370
370
|
4. **Manual Migration**: Follow manual migration steps above
|
|
371
371
|
|
package/docs/PASS_QUICK_START.md
CHANGED
package/docs/PRIVACY.md
CHANGED
|
@@ -176,7 +176,7 @@ Anonymous usage statistics help us:
|
|
|
176
176
|
|
|
177
177
|
If you have questions about our privacy policy or data collection:
|
|
178
178
|
|
|
179
|
-
- **GitHub Issues**: https://github.com/
|
|
179
|
+
- **GitHub Issues**: https://github.com/hamr0/liteagents/issues
|
|
180
180
|
- **Review Code**: Our telemetry code is open source in `installer/telemetry.js`
|
|
181
181
|
- **Request Clarification**: Open an issue if anything is unclear
|
|
182
182
|
|
package/docs/PUBLISHING.md
CHANGED
|
@@ -96,7 +96,7 @@ Claude Code doesn't have a centralized official Anthropic marketplace yet. There
|
|
|
96
96
|
Users can install directly from GitHub without marketplace approval:
|
|
97
97
|
|
|
98
98
|
```
|
|
99
|
-
/plugin add github:
|
|
99
|
+
/plugin add github:hamr0/liteagents
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
**No submission required!** Works as soon as you push to GitHub.
|
|
@@ -113,12 +113,12 @@ Host your own marketplace catalog: `.claude-plugin/marketplace.json`
|
|
|
113
113
|
```json
|
|
114
114
|
{
|
|
115
115
|
"name": "liteagents Official",
|
|
116
|
-
"owner": "
|
|
116
|
+
"owner": "hamr0",
|
|
117
117
|
"description": "Lightweight CLI agents for development",
|
|
118
118
|
"plugins": [
|
|
119
119
|
{
|
|
120
120
|
"name": "liteagents",
|
|
121
|
-
"source": "github:
|
|
121
|
+
"source": "github:hamr0/liteagents",
|
|
122
122
|
"description": "Lightweight deterministic CLI agents"
|
|
123
123
|
}
|
|
124
124
|
]
|
|
@@ -127,7 +127,7 @@ Host your own marketplace catalog: `.claude-plugin/marketplace.json`
|
|
|
127
127
|
|
|
128
128
|
Users install via:
|
|
129
129
|
```
|
|
130
|
-
/plugin marketplace add github:
|
|
130
|
+
/plugin marketplace add github:hamr0/liteagents
|
|
131
131
|
```
|
|
132
132
|
|
|
133
133
|
### Option 3: Submit to Community Marketplaces
|
|
@@ -221,7 +221,7 @@ npm login
|
|
|
221
221
|
|
|
222
222
|
#### GitHub Install Not Working
|
|
223
223
|
|
|
224
|
-
**Problem:** Users can't install via `/plugin add github:
|
|
224
|
+
**Problem:** Users can't install via `/plugin add github:hamr0/liteagents`
|
|
225
225
|
|
|
226
226
|
**Checklist:**
|
|
227
227
|
- [ ] Repository is public
|
|
@@ -245,7 +245,7 @@ Before publishing a new release:
|
|
|
245
245
|
- [ ] Changes pushed to GitHub with tags
|
|
246
246
|
- [ ] Published to npm: `./scripts/publish.sh`
|
|
247
247
|
- [ ] Verified npm installation: `npm install -g liteagents`
|
|
248
|
-
- [ ] Verified GitHub installation: `/plugin add github:
|
|
248
|
+
- [ ] Verified GitHub installation: `/plugin add github:hamr0/liteagents`
|
|
249
249
|
|
|
250
250
|
---
|
|
251
251
|
|
|
@@ -254,7 +254,7 @@ Before publishing a new release:
|
|
|
254
254
|
After publishing, your package will be available at:
|
|
255
255
|
|
|
256
256
|
- **npm:** https://www.npmjs.com/package/liteagents
|
|
257
|
-
- **GitHub Repository:** https://github.com/
|
|
257
|
+
- **GitHub Repository:** https://github.com/hamr0/liteagents
|
|
258
258
|
|
|
259
259
|
## Support & Resources
|
|
260
260
|
|
|
@@ -300,8 +300,8 @@ This release represents a significant milestone in making Agentic Kit more acces
|
|
|
300
300
|
|
|
301
301
|
## 📞 Support
|
|
302
302
|
|
|
303
|
-
- **Documentation**: https://github.com/
|
|
304
|
-
- **Issues**: https://github.com/
|
|
303
|
+
- **Documentation**: https://github.com/hamr0/liteagents/docs
|
|
304
|
+
- **Issues**: https://github.com/hamr0/liteagents/issues
|
|
305
305
|
- **Security**: See [SECURITY.md](docs/SECURITY.md) for vulnerability reporting
|
|
306
306
|
|
|
307
307
|
---
|
|
@@ -466,7 +466,7 @@ If you encounter issues:
|
|
|
466
466
|
2. Review the installation log at `~/.liteagents-install.log`
|
|
467
467
|
3. Run with `--help` to see all available options
|
|
468
468
|
4. Try interactive mode first to diagnose issues
|
|
469
|
-
5. Report issues at: https://github.com/
|
|
469
|
+
5. Report issues at: https://github.com/hamr0/liteagents/issues
|
|
470
470
|
|
|
471
471
|
## Best Practices
|
|
472
472
|
|
package/installer/cli.js
CHANGED
|
@@ -456,7 +456,7 @@ ${colors.bright}${colors.cyan}██╔══██║██║ ██║█
|
|
|
456
456
|
${colors.bright}${colors.cyan}██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ██║╚██████╗ ██║ ██╗██║ ██║${colors.reset}
|
|
457
457
|
${colors.bright}${colors.cyan}╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝${colors.reset}
|
|
458
458
|
|
|
459
|
-
${colors.bright}v2.
|
|
459
|
+
${colors.bright}v2.6.0 | 11 agents + 23 commands per tool${colors.reset}
|
|
460
460
|
`);
|
|
461
461
|
}
|
|
462
462
|
|