@fingerskier/augment 0.1.0 → 0.1.2

package/integrations/codex/SKILL.md

@@ -1,29 +1,63 @@
----
-name: augment-context
-description: Use Augment MCP memories to gather and persist project context during coding sessions.
----
-
-# Augment Context
-
-Use this skill when working in a repository with the Augment MCP server available.
-
-## Workflow
-
-1. At session start, call `init_project`.
-2. Search for context using a concise task summary.
-3. Before substantial edits, search again for the specific file, component, or behavior.
-4. Persist durable findings with `upsert`:
-   - `SPEC` for requirements and contracts.
-   - `ARCH` for design decisions.
-   - `TODO` for planned work.
-   - `ISSUE` for bugs, risks, and blockers.
-   - `WORK` for concise implementation notes.
-5. Link related memories when the relationship is clear.
-6. At finish, write a short `WORK` memory describing what changed and how it was verified.
-
-## Guardrails
-- Do not store secrets, credentials, tokens, or private keys.
-- Do not store huge logs, dependency dumps, generated files, or full source files.
-- Keep each memory focused; split large notes before calling `upsert`.
-- Treat numeric memory IDs as local handles. Relative paths are the durable identity.
-- Use returned search text directly as context; do not ask Augment to summarize.
+---
+name: augment-context
+description: Use Augment MCP memories to gather and persist project context during coding sessions.
+---
+
+# Augment Context
+
+Use this skill when working in a repository with the Augment MCP server available.
+
+## Session Start
+
+1. Call `init_project`.
+2. Call `search` with the user's task summary.
+3. Read exact memories when search results identify likely governing context.
+
+## Before Code Changes
+
+1. Search for the file, component, command, error, or behavior being touched.
+2. If the work depends on a prior decision, read and follow the relevant `SPEC`
+   or `ARCH` memory.
+3. If no relevant memory exists but the task creates a durable requirement or
+   decision, create one before implementation.
+
+## Memory Triggers
+
+Call `upsert` whenever one of these durable events happens:
+
+- A requirement, API contract, data model, or tool contract is clarified:
+  use `SPEC`.
+- An implementation approach, tradeoff, transport choice, persistence model, or
+  architecture decision is made: use `ARCH`.
+- A bug, risk, failing behavior, or blocker is discovered: use `ISSUE`.
+- Follow-up work is intentionally deferred: use `TODO`.
+- A meaningful implementation milestone is completed: use `WORK`.
+- A test scenario, regression case, or verification rule is learned: use `SPEC`
+  or `WORK`, whichever is more durable.
+
+## Links
+
+After creating or updating a memory:
+
+1. Use `link` when a memory implements, depends on, blocks, parents, or relates
+   to another memory.
+2. Prefer linking new `WORK` notes to the `SPEC`, `ARCH`, `ISSUE`, or `TODO`
+   they address.
+
+## Session Finish
+
+For every non-trivial session:
+
+1. Upsert a concise `WORK` memory with what changed, key files, and verification.
+2. Upsert or update `TODO` memories for known remaining work.
+3. Link the final `WORK` memory to the relevant planning/decision memories.
+
+## Guardrails
+
+- Do not store secrets, credentials, tokens, or private keys.
+- Do not store huge logs, dependency dumps, generated files, or full source files.
+- Keep each memory focused; split large notes before calling `upsert`.
+- Treat numeric memory IDs as local handles. Relative paths are the durable identity.
+- Use returned search text directly as context; do not ask Augment to summarize.
+- Do not create memories for trivial edits, transient exploration, or facts that
+  are already obvious from the current diff.

package/integrations/examples/claude-mcp-config.json

@@ -2,7 +2,16 @@
   "mcpServers": {
     "augment": {
       "command": "npm",
-      "args": ["exec", "--yes", "--package", "@fingerskier/augment", "--", "augment-mcp"],
+      "args": [
+        "exec",
+        "--yes",
+        "--prefix",
+        "C:\\Users\\you\\.augment\\npm-exec",
+        "--package",
+        "@fingerskier/augment",
+        "--",
+        "augment-mcp"
+      ],
       "env": {
         "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
       }

package/integrations/examples/codex-mcp-config.json

@@ -2,7 +2,16 @@
   "mcpServers": {
     "augment": {
       "command": "npm",
-      "args": ["exec", "--yes", "--package", "@fingerskier/augment", "--", "augment-mcp"],
+      "args": [
+        "exec",
+        "--yes",
+        "--prefix",
+        "C:\\Users\\you\\.augment\\npm-exec",
+        "--package",
+        "@fingerskier/augment",
+        "--",
+        "augment-mcp"
+      ],
       "env": {
         "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
       }

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "@fingerskier/augment",
-  "version": "0.1.0",
-  "description": "Local RAG memory system for coding agents",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "augment": "./dist/bin/augment.js",
-    "augment-daemon": "./dist/bin/augment-daemon.js",
-    "augment-mcp": "./dist/bin/augment-mcp.js"
-  },
-  "files": [
-    "dist",
-    "docs",
-    "integrations",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "node --import tsx --test \"test/**/*.test.ts\"",
-    "check": "npm run build && npm test",
-    "prepack": "npm run check",
-    "prepublishOnly": "npm run check"
-  },
-  "dependencies": {
-    "@huggingface/transformers": "^3.8.0",
-    "@libsql/client": "^0.15.15",
-    "@modelcontextprotocol/sdk": "^1.17.5",
-    "chokidar": "^4.0.3",
-    "gray-matter": "^4.0.3",
-    "zod": "^3.25.76"
-  },
-  "devDependencies": {
-    "@types/node": "^24.3.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "license": "Apache-2.0"
-}
+{
+  "name": "@fingerskier/augment",
+  "version": "0.1.2",
+  "description": "Local RAG memory system for coding agents",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "augment": "./dist/bin/augment.js",
+    "augment-daemon": "./dist/bin/augment-daemon.js",
+    "augment-mcp": "./dist/bin/augment-mcp.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "integrations",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test \"test/**/*.test.ts\"",
+    "check": "npm run build && npm test",
+    "prepack": "npm run check",
+    "prepublishOnly": "npm run check"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.8.0",
+    "@libsql/client": "^0.15.15",
+    "@modelcontextprotocol/sdk": "^1.23.0",
+    "chokidar": "^4.0.3",
+    "gray-matter": "^4.0.3",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "Apache-2.0"
+}