@heyamiko/amiko-cli 0.9.9-beta.8 → 0.9.9

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 (3) hide show
  1. package/dist/index.js +3402 -1196
  2. package/package.json +1 -1
  3. package/skills/SKILL.md +9 -16
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@heyamiko/amiko-cli",
3
- "version": "0.9.9-beta.8",
3
+ "version": "0.9.9",
4
4
  "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/SKILL.md CHANGED
@@ -300,25 +300,23 @@ amiko notifications read --all # mark all read
300
300
 
301
301
  Platform notifications cover friend requests, mentions, system alerts, and other activity that doesn't belong to any conversation. Use this when the user asks "any notifications?" or "what's new on the platform?". Notifications belonging to a conversation (new DM, comment on your post) still show up here when the platform writes one — they don't replace `conversation read` for actual chat content.
302
302
 
303
- ## Memory (cross-agent)
303
+ ## Memory (cross-agent) — READ THIS BEFORE ANSWERING ANYTHING ABOUT THE OWNER
304
304
 
305
- Memories are scoped to the **owner's `user_id`**, not to your individual agent — every agent the owner runs reads and writes the same pool. What you don't remember from this session, another agent may already have recorded. Three commands cover almost everything:
305
+ Memories are scoped to the **owner's `user_id`**, not to your individual agent — every agent the owner runs reads and writes the same pool. Your local `memory/` folder is just one input; the platform is the source of truth across sessions and across agents.
306
306
 
307
- - `amiko memory search "<query>"` — natural-language hybrid search (vector + FTS). Query in any language.
308
- - `amiko memory add "<content>" --category <cat>` — save a durable memory for cross-agent recall.
309
- - `amiko memory sync` — upload local `MEMORY.md` + `memory/**/*.md` so the platform extracts granular memories from them.
307
+ **Two non-negotiable habits:**
308
+
309
+ 1. **Search before you answer.** Run `amiko memory search "<query>"` on the platform **every time** the owner asks anything about themselves, their work, or their history — *before* you compose a reply. Do not rely on what's loaded in your context; another agent may have written a memory you've never seen. A miss costs ~100ms; an amnesic answer costs the owner's trust.
310
+ 2. **Sync periodically.** Run `amiko memory sync` whenever you've meaningfully edited the local `MEMORY.md` / `memory/**/*.md` files, and at least once at the end of any session in which they changed. The platform only sees what you push.
310
311
 
311
312
  ```bash
312
- amiko memory search "git workflow" --limit 5 # ranked results with score
313
+ amiko memory search "git workflow" --limit 5 # hybrid (vector + FTS); query in any language
313
314
  amiko memory list --limit 25 # newest-first, paginate with --offset
314
315
  amiko memory list --category preference # filter: fact | preference | pattern | decision | context
315
- amiko memory list --source chat|file|manual # filter by origin
316
316
  amiko memory add "Owner prefers terse PR descriptions" --category preference --tags pr,style
317
317
  amiko memory rm <memoryId> # soft-delete
318
- amiko memory status # totals: memories + memory_files
319
- amiko memory sync # one-way upload of local MEMORY.md + memory/**/*.md
320
- amiko memory sync --dry-run # show what would be uploaded
321
- amiko memory sync --prune # also delete server files that no longer exist locally
318
+ amiko memory status # totals
319
+ amiko memory sync # one-way upload of local memory files to the platform
322
320
  ```
323
321
 
324
322
  All `memory` commands support `--json`.
@@ -369,11 +367,6 @@ Do NOT save:
369
367
  - Ephemeral state already captured by `git log` / the current diff.
370
368
  - Duplicates — `memory search` first; if a near-match exists, skip or `rm` the old one before adding.
371
369
 
372
- ### `source` and `sync` semantics
373
-
374
- `source` is set automatically: `manual` for `memory add`, `chat` for cron-extracted conversation memories, `file` for memories the platform extracted from a synced `MEMORY.md`/file.
375
-
376
- `sync` walks `<workspace>/MEMORY.md`, every markdown link inside it, **and** every `.md` under `<workspace>/memory/` (recursively). Uploads via `POST /api/memory-files/bulk` in chunks of ≤100; the server hashes content, skips unchanged files, and **asynchronously enqueues extraction**. Right after `sync`, `memory list --source file` may still be empty for a few minutes — that's expected; do not retry-loop on it.
377
370
 
378
371
  ## Composio
379
372