@gramatr/client 0.6.2 → 0.6.3
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/CLAUDE.md +1 -1
- package/README.md +2 -2
- package/bin/clear-creds.ts +1 -1
- package/bin/uninstall.ts +1 -1
- package/chatgpt/README.md +1 -1
- package/codex/README.md +2 -2
- package/core/version-check.ts +2 -2
- package/desktop/README.md +1 -1
- package/gemini/README.md +3 -3
- package/hooks/session-start.hook.ts +1 -1
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -10,7 +10,7 @@ ISC scaffold, capability audit, phase templates, and composed agents.
|
|
|
10
10
|
**Memory:** Use gramatr MCP tools (`search_semantic`, `create_entity`, `add_observation`),
|
|
11
11
|
not local markdown files.
|
|
12
12
|
|
|
13
|
-
**Identity:** Read from
|
|
13
|
+
**Identity:** Read from `~/.gramatr/settings.json` — `daidentity` for your name,
|
|
14
14
|
`principal` for the user's name.
|
|
15
15
|
|
|
16
16
|
**If the server is unreachable:** Use 7-phase structure (OBSERVE → THINK → PLAN → BUILD →
|
package/README.md
CHANGED
|
@@ -72,14 +72,14 @@ The client never stores intelligence locally. The server delivers everything: be
|
|
|
72
72
|
## What gets installed
|
|
73
73
|
|
|
74
74
|
```
|
|
75
|
-
|
|
75
|
+
~/.gramatr/ # Client runtime
|
|
76
76
|
hooks/ # 8 lifecycle hooks
|
|
77
77
|
core/ # Shared routing + session logic
|
|
78
78
|
bin/ # Status line, login, utilities
|
|
79
79
|
CLAUDE.md # Minimal behavioral framework
|
|
80
80
|
~/.claude/settings.json # Hook configuration (merged, not overwritten)
|
|
81
81
|
~/.claude.json # MCP server registration
|
|
82
|
-
~/.
|
|
82
|
+
~/.gramatr.json # Auth token (canonical source)
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
## Commands
|
package/bin/clear-creds.ts
CHANGED
|
@@ -40,7 +40,7 @@ function showHelp(): void {
|
|
|
40
40
|
log(`gramatr clear-creds — Remove every stored gramatr credential
|
|
41
41
|
|
|
42
42
|
Usage:
|
|
43
|
-
gramatr clear-creds Sweep ~/.gramatr.json + auth.api_key from
|
|
43
|
+
gramatr clear-creds Sweep ~/.gramatr.json + auth.api_key from ~/.gramatr/settings.json
|
|
44
44
|
|
|
45
45
|
After running, the next install or login will be forced through OAuth.
|
|
46
46
|
|
package/bin/uninstall.ts
CHANGED
|
@@ -170,7 +170,7 @@ async function main(): Promise<void> {
|
|
|
170
170
|
try {
|
|
171
171
|
const settings = JSON.parse(readFileSync(claudeSettings, 'utf8'));
|
|
172
172
|
if (settings.hooks) {
|
|
173
|
-
// Remove hook entries that reference
|
|
173
|
+
// Remove hook entries that reference .gramatr or gramatr paths
|
|
174
174
|
for (const [event, hooks] of Object.entries(settings.hooks)) {
|
|
175
175
|
if (Array.isArray(hooks)) {
|
|
176
176
|
settings.hooks[event] = (hooks as any[]).filter(
|
package/chatgpt/README.md
CHANGED
|
@@ -19,7 +19,7 @@ bun chatgpt/install.ts
|
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
The installer will:
|
|
22
|
-
1. Find your API key from `~/.
|
|
22
|
+
1. Find your API key from `~/.gramatr.json`, `GRAMATR_API_KEY` env, or prompt you
|
|
23
23
|
2. Validate connectivity to the gramatr server
|
|
24
24
|
3. Detect your platform and locate the ChatGPT config file
|
|
25
25
|
4. Merge the gramatr MCP server entry without overwriting existing servers
|
package/codex/README.md
CHANGED
|
@@ -21,8 +21,8 @@ Install locally with:
|
|
|
21
21
|
- `pnpm --filter @gramatr/client install-codex`
|
|
22
22
|
|
|
23
23
|
The installer:
|
|
24
|
-
- syncs this Codex runtime into
|
|
25
|
-
- syncs the shared `gmtr-hook-utils.ts` dependency into
|
|
24
|
+
- syncs this Codex runtime into `~/.gramatr/codex`
|
|
25
|
+
- syncs the shared `gmtr-hook-utils.ts` dependency into `~/.gramatr/hooks/lib`
|
|
26
26
|
- merges `~/.codex/hooks.json`
|
|
27
27
|
- enables `codex_hooks` in `~/.codex/config.toml`
|
|
28
28
|
- upserts a managed gramatr block in `~/.codex/AGENTS.md`
|
package/core/version-check.ts
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* version-check.ts — opportunistic npm registry version check.
|
|
3
3
|
*
|
|
4
4
|
* Queries https://registry.npmjs.org/gramatr/latest on a 3s timeout, caches
|
|
5
|
-
* the result for one hour under ~/.
|
|
5
|
+
* the result for one hour under ~/.gramatr/.cache/version-check.json, and
|
|
6
6
|
* reports whether the installed client is behind the published version.
|
|
7
7
|
*
|
|
8
8
|
* Design constraints (see issue #468 sibling work):
|
|
@@ -56,7 +56,7 @@ export function compareVersions(a: string, b: string): number {
|
|
|
56
56
|
}
|
|
57
57
|
|
|
58
58
|
export function getCachePath(home: string = homedir()): string {
|
|
59
|
-
return join(home, '.
|
|
59
|
+
return join(home, '.gramatr', '.cache', 'version-check.json');
|
|
60
60
|
}
|
|
61
61
|
|
|
62
62
|
function readCache(path: string): CacheFile | null {
|
package/desktop/README.md
CHANGED
|
@@ -12,7 +12,7 @@ bun packages/client/desktop/install.ts
|
|
|
12
12
|
```
|
|
13
13
|
|
|
14
14
|
The installer:
|
|
15
|
-
1. Resolves your API key from `~/.
|
|
15
|
+
1. Resolves your API key from `~/.gramatr.json`, `GRAMATR_API_KEY` env, or prompts
|
|
16
16
|
2. Validates connectivity to the gramatr server
|
|
17
17
|
3. Detects platform (macOS or Windows)
|
|
18
18
|
4. Reads existing `claude_desktop_config.json` without overwriting other MCP servers
|
package/gemini/README.md
CHANGED
|
@@ -62,7 +62,7 @@ echo "GRAMATR_API_KEY=your-key-here" > ~/.gemini/extensions/gramatr/.env
|
|
|
62
62
|
|
|
63
63
|
gramatr requires a Bearer token for all MCP calls. The installer handles this by:
|
|
64
64
|
|
|
65
|
-
1. Checking `~/.
|
|
65
|
+
1. Checking `~/.gramatr.json` for an existing token (shared with Claude Code / Codex)
|
|
66
66
|
2. Checking the `GRAMATR_API_KEY` environment variable
|
|
67
67
|
3. Prompting for a token interactively
|
|
68
68
|
|
|
@@ -72,7 +72,7 @@ To authenticate before installing, run:
|
|
|
72
72
|
bun packages/client/bin/gmtr-login.ts
|
|
73
73
|
```
|
|
74
74
|
|
|
75
|
-
This stores the token in `~/.
|
|
75
|
+
This stores the token in `~/.gramatr.json`, which the installer reads automatically.
|
|
76
76
|
|
|
77
77
|
API keys start with `gramatr_sk_` and can be created at [gramatr.com](https://gramatr.com) or via the `gramatr_create_api_key` MCP tool.
|
|
78
78
|
|
|
@@ -92,4 +92,4 @@ After installing and restarting Gemini CLI:
|
|
|
92
92
|
> @gramatr search for recent learning signals
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
If the MCP server responds, the extension is working. If you see auth errors, re-run the installer or check `~/.
|
|
95
|
+
If the MCP server responds, the extension is working. If you see auth errors, re-run the installer or check `~/.gramatr.json`.
|
|
@@ -321,7 +321,7 @@ async function main(): Promise<void> {
|
|
|
321
321
|
log('This will:');
|
|
322
322
|
log(` 1. Search gramatr for existing project: ${git.projectName}`);
|
|
323
323
|
log(' 2. Create project entity if not found');
|
|
324
|
-
log(' 3. Link entity to .
|
|
324
|
+
log(' 3. Link entity to .gramatr.json');
|
|
325
325
|
log(' 4. Enable full memory persistence');
|
|
326
326
|
log('');
|
|
327
327
|
} else {
|