@gramatr/client 0.5.2 → 0.6.1

package/bin/add-api-key.ts

@@ -4,13 +4,13 @@
  *
  * Three modes:
  *   1. Interactive prompt:    gramatr add-api-key
- *   2. Piped stdin:           echo "gmtr_sk_..." | gramatr add-api-key
+ *   2. Piped stdin:           echo "gramatr_sk_..." | gramatr add-api-key
  *   3. Env-sourced:           gramatr add-api-key --from-env GRAMATR_API_KEY
  *
  * The key is validated against the gramatr server before being written
- * to ~/.gmtr.json. Use --force to skip server validation when offline.
+ * to ~/.gramatr.json. Use --force to skip server validation when offline.
  *
- * This command is the ONLY way to put an API key into ~/.gmtr.json.
+ * This command is the ONLY way to put an API key into ~/.gramatr.json.
  * Installers never prompt for API keys — see packages/client/core/auth.ts.
  */
 
@@ -20,13 +20,13 @@ import { join } from "path";
 import { createInterface } from "readline";
 
 function gmtrJsonPath(): string {
-  return join(process.env.HOME || process.env.USERPROFILE || homedir(), ".gmtr.json");
+  return join(process.env.HOME || process.env.USERPROFILE || homedir(), ".gramatr.json");
 }
-const SERVER_BASE = (process.env.GMTR_URL || "https://api.gramatr.com").replace(/\/mcp\/?$/, "");
+const SERVER_BASE = (process.env.GRAMATR_URL || "https://api.gramatr.com").replace(/\/mcp\/?$/, "");
 
-// Accept gmtr_sk_, gmtr_pk_, aios_sk_, aios_pk_ (legacy), and Firebase-style
+// Accept gramatr_sk_, gramatr_pk_, aios_sk_, aios_pk_ (legacy), and Firebase-style
 // long opaque tokens (length >= 32, base64url-ish characters).
-const KEY_FORMAT = /^(gmtr|aios)_(sk|pk)_[A-Za-z0-9_-]+$/;
+const KEY_FORMAT = /^(gramatr|gmtr|aios)_(sk|pk)_[A-Za-z0-9_-]+$/;
 const LEGACY_OPAQUE = /^[A-Za-z0-9_.-]{32,}$/;
 
 function log(msg: string = ""): void {
@@ -59,11 +59,11 @@ function parseArgs(argv: string[]): {
 }
 
 function showHelp(): void {
-  log(`gramatr add-api-key — Add a gramatr API key to ~/.gmtr.json
+  log(`gramatr add-api-key — Add a gramatr API key to ~/.gramatr.json
 
 Usage:
   gramatr add-api-key                      Interactive prompt for the key
-  echo "gmtr_sk_..." | gramatr add-api-key Read key from piped stdin
+  echo "gramatr_sk_..." | gramatr add-api-key Read key from piped stdin
   gramatr add-api-key --from-env VAR       Read key from named env variable
   gramatr add-api-key --force              Skip server validation (offline use)
 
@@ -94,7 +94,7 @@ async function readPipedStdin(): Promise<string | null> {
 async function readInteractive(): Promise<string> {
   log("");
   log("Paste your gramatr API key below.");
-  log("(Get one at https://gramatr.com/settings — keys start with gmtr_sk_)");
+  log("(Get one at https://gramatr.com/settings — keys start with gramatr_sk_)");
   log("");
   process.stdout.write("  Key: ");
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -168,7 +168,7 @@ function writeKey(key: string): void {
   }
   existing.token = key;
   existing.token_type =
-    key.startsWith("gmtr_sk_") || key.startsWith("aios_sk_") ? "api_key" : "oauth";
+    key.startsWith("gramatr_sk_") || key.startsWith("aios_sk_") ? "api_key" : "oauth";
   existing.authenticated_at = new Date().toISOString();
   writeFileSync(gmtrJsonPath(), `${JSON.stringify(existing, null, 2)}\n`, "utf8");
   try {
@@ -214,7 +214,7 @@ export async function main(argv: string[] = process.argv.slice(2)): Promise<numb
 
   // Format validation
   if (!validateFormat(key)) {
-    err("ERROR: key format is invalid. Expected gmtr_sk_... or gmtr_pk_...");
+    err("ERROR: key format is invalid. Expected gramatr_sk_... or gramatr_pk_...");
     return 1;
   }
 

package/bin/clean-legacy-install.ts

@@ -14,8 +14,8 @@ function main(): void {
   }
 
   const apply = process.argv.includes('--apply');
-  const includeOptionalUx = process.env.GMTR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
-  const clientDir = process.env.GMTR_DIR || join(home, 'gmtr-client');
+  const includeOptionalUx = process.env.GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
+  const clientDir = process.env.GRAMATR_DIR || join(home, '.gramatr');
   runLegacyMigration({
     homeDir: home,
     clientDir,

package/bin/clear-creds.ts

@@ -2,15 +2,15 @@
 /**
  * gramatr clear-creds — Nuke ALL stored gramatr credentials.
  *
- * Stronger than `gramatr logout` (which only removes ~/.gmtr.json).
+ * Stronger than `gramatr logout` (which only removes ~/.gramatr.json).
  * This sweeps every credential location in the resolveAuthToken chain
  * (core/auth.ts), so the next install/login is forced through OAuth.
  *
  * Locations cleared:
- *   1. ~/.gmtr.json                              — deleted entirely
- *   2. ~/gmtr-client/settings.json `auth.api_key` — stripped, file preserved
+ *   1. ~/.gramatr.json                              — deleted entirely
+ *   2. ~/.gramatr/settings.json `auth.api_key` — stripped, file preserved
  *
- * Env vars (GRAMATR_API_KEY, GMTR_TOKEN) cannot be cleared from a child
+ * Env vars (GRAMATR_API_KEY, GRAMATR_TOKEN) cannot be cleared from a child
  * process — they live in the parent shell. We detect them and warn.
  *
  * Not-logged-in is not an error: exits 0 with a clean message.
@@ -24,11 +24,11 @@ function getHome(): string {
 }
 
 function gmtrJsonPath(): string {
-  return join(getHome(), ".gmtr.json");
+  return join(getHome(), ".gramatr.json");
 }
 
 function legacySettingsPath(): string {
-  const gmtrDir = process.env.GMTR_DIR || join(getHome(), "gmtr-client");
+  const gmtrDir = process.env.GRAMATR_DIR || join(getHome(), ".gramatr");
   return join(gmtrDir, "settings.json");
 }
 
@@ -40,11 +40,11 @@ function showHelp(): void {
   log(`gramatr clear-creds — Remove every stored gramatr credential
 
 Usage:
-  gramatr clear-creds   Sweep ~/.gmtr.json + auth.api_key from gmtr-client/settings.json
+  gramatr clear-creds   Sweep ~/.gramatr.json + auth.api_key from gmtr-client/settings.json
 
 After running, the next install or login will be forced through OAuth.
 
-Env vars (GRAMATR_API_KEY, GMTR_TOKEN) cannot be unset from this process.
+Env vars (GRAMATR_API_KEY, GRAMATR_TOKEN) cannot be unset from this process.
 If they are set, this command warns and tells you the shell command to run.`);
 }
 
@@ -61,14 +61,14 @@ export function clearAll(): ClearResult {
     envVarsSet: [],
   };
 
-  // 1. ~/.gmtr.json — delete entirely
+  // 1. ~/.gramatr.json — delete entirely
   const gj = gmtrJsonPath();
   if (existsSync(gj)) {
     unlinkSync(gj);
     result.removedGmtrJson = true;
   }
 
-  // 2. ~/gmtr-client/settings.json — strip auth.api_key, preserve rest
+  // 2. ~/.gramatr/settings.json — strip auth.api_key, preserve rest
   const ls = legacySettingsPath();
   if (existsSync(ls)) {
     try {
@@ -86,7 +86,7 @@ export function clearAll(): ClearResult {
   }
 
   // 3. Env vars — detect only, cannot mutate parent shell
-  for (const v of ["GRAMATR_API_KEY", "GMTR_TOKEN"]) {
+  for (const v of ["GRAMATR_API_KEY", "GRAMATR_TOKEN"]) {
     if (process.env[v]) result.envVarsSet.push(v);
   }
 

package/bin/gmtr-login.ts

@@ -3,7 +3,7 @@
  * gmtr-login — Authenticate with the gramatr server
  *
  * Opens the grāmatr dashboard login flow, captures a Firebase ID token
- * on localhost, and stores it in ~/.gmtr.json.
+ * on localhost, and stores it in ~/.gramatr.json.
  *
  * Usage:
  *   bun gmtr-login.ts                    # Interactive browser login via Firebase dashboard
@@ -11,7 +11,7 @@
  *   bun gmtr-login.ts --status           # Check current auth status
  *   bun gmtr-login.ts --logout           # Remove stored credentials
  *
- * Token is stored in ~/.gmtr.json under the "token" key.
+ * Token is stored in ~/.gramatr.json under the "token" key.
  * The GMTRPromptEnricher hook reads this on every prompt.
  */
 
@@ -23,8 +23,8 @@ import { createServer, type IncomingMessage, type ServerResponse } from 'http';
 // ── Config ──
 
 const HOME = process.env.HOME || process.env.USERPROFILE || '';
-const CONFIG_PATH = join(HOME, '.gmtr.json');
-const DEFAULT_SERVER = process.env.GMTR_URL || 'https://api.gramatr.com/mcp';
+const CONFIG_PATH = join(HOME, '.gramatr.json');
+const DEFAULT_SERVER = process.env.GRAMATR_URL || 'https://api.gramatr.com/mcp';
 // Strip /mcp suffix to get base URL
 const SERVER_BASE = DEFAULT_SERVER.replace(/\/mcp\/?$/, '');
 const DASHBOARD_BASE = process.env.GMTR_DASHBOARD_URL || (() => {
@@ -317,7 +317,7 @@ async function logout(): Promise<void> {
   delete config.token_expires;
   delete config.authenticated_at;
   writeConfig(config);
-  console.log('\n  ✓ Logged out. Token removed from ~/.gmtr.json\n');
+  console.log('\n  ✓ Logged out. Token removed from ~/.gramatr.json\n');
 }
 
 async function loginWithToken(token: string): Promise<void> {
@@ -327,10 +327,10 @@ async function loginWithToken(token: string): Promise<void> {
   if (result.valid) {
     const config = readConfig();
     config.token = token;
-    config.token_type = token.startsWith('aios_sk_') || token.startsWith('gmtr_sk_') ? 'api_key' : 'oauth';
+    config.token_type = token.startsWith('aios_sk_') || token.startsWith('gramatr_sk_') ? 'api_key' : 'oauth';
     config.authenticated_at = new Date().toISOString();
     writeConfig(config);
-    console.log('  ✓ Token valid. Saved to ~/.gmtr.json');
+    console.log('  ✓ Token valid. Saved to ~/.gramatr.json');
     console.log('  gramatr intelligence is now active.\n');
   } else {
     console.log(`  ✗ Token rejected: ${result.error}`);
@@ -396,7 +396,7 @@ async function loginBrowser(): Promise<void> {
 
       console.log('');
       console.log('  ✓ Authenticated successfully');
-      console.log('  Token saved to ~/.gmtr.json');
+      console.log('  Token saved to ~/.gramatr.json');
       console.log('  gramatr intelligence is now active.\n');
       return;
     } catch (e: any) {
@@ -503,7 +503,7 @@ async function loginBrowser(): Promise<void> {
 
     console.log('');
     console.log('  ✓ Authenticated successfully');
-    console.log('  Token saved to ~/.gmtr.json');
+    console.log('  Token saved to ~/.gramatr.json');
     console.log('  gramatr intelligence is now active.\n');
   } catch (e: any) {
     console.log(`\n  ✗ Authentication failed: ${e.message}\n`);
@@ -539,7 +539,7 @@ export async function main(): Promise<void> {
     if (!token) {
       // Interactive paste mode — like Claude's login
       console.log('\n  Paste your gramatr token below.');
-      console.log('  (API keys start with aios_sk_ or gmtr_sk_)\n');
+      console.log('  (API keys start with aios_sk_ or gramatr_sk_)\n');
       process.stdout.write('  Token: ');
 
       const { createInterface } = await import('readline');
@@ -570,7 +570,7 @@ export async function main(): Promise<void> {
     gmtr-login --logout     Remove stored credentials
     gmtr-login --help       Show this help
 
-  Token storage: ~/.gmtr.json
+  Token storage: ~/.gramatr.json
   Server: ${SERVER_BASE}
   Dashboard: ${DASHBOARD_BASE}
 `);

package/bin/gramatr.ts

@@ -205,11 +205,11 @@ function installTarget(targetId: IntegrationTargetId): void {
 
 function migrate(apply: boolean, deep: boolean = false): void {
   const homeDir = homedir();
-  const clientDir = process.env.GMTR_DIR || join(homeDir, 'gmtr-client');
+  const clientDir = process.env.GRAMATR_DIR || join(homeDir, '.gramatr');
   runLegacyMigration({
     homeDir,
     clientDir,
-    includeOptionalUx: process.env.GMTR_ENABLE_OPTIONAL_CLAUDE_UX === '1',
+    includeOptionalUx: process.env.GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX === '1',
     apply,
     log,
   });
@@ -220,7 +220,7 @@ function migrate(apply: boolean, deep: boolean = false): void {
 }
 
 function doctor(): void {
-  const gmtrDir = process.env.GMTR_DIR || join(homedir(), 'gmtr-client');
+  const gmtrDir = process.env.GRAMATR_DIR || join(homedir(), '.gramatr');
   const stale = findStaleArtifacts(homedir(), gmtrDir, existsSync);
   for (const line of formatDoctorLines(detectTargets(), gmtrDir, existsSync(gmtrDir), stale)) log(line);
   renderRemoteGuidance();
@@ -228,14 +228,14 @@ function doctor(): void {
 
 function upgrade(): void {
   const homeDir = homedir();
-  const clientDir = process.env.GMTR_DIR || join(homeDir, 'gmtr-client');
+  const clientDir = process.env.GRAMATR_DIR || join(homeDir, '.gramatr');
   const stale = findStaleArtifacts(homeDir, clientDir, existsSync);
   if (stale.length > 0) {
     log('Cleaning stale legacy artifacts before upgrade...');
     runLegacyMigration({
       homeDir,
       clientDir,
-      includeOptionalUx: process.env.GMTR_ENABLE_OPTIONAL_CLAUDE_UX === '1',
+      includeOptionalUx: process.env.GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX === '1',
       apply: true,
       log,
     });
@@ -344,7 +344,7 @@ function main(): void {
       log('  install [target]   Install gramatr (claude-code, codex, gemini-cli, all)');
       log('  login              Authenticate with the gramatr server (OAuth)');
       log('  add-api-key        Add an API key explicitly (interactive / piped / --from-env)');
-      log('  logout             Clear session token (~/.gmtr.json)');
+      log('  logout             Clear session token (~/.gramatr.json)');
       log('  clear-creds        Nuke ALL stored credentials, force OAuth on next login');
       log('  detect             Show detected CLI platforms');
       log('  doctor             Check installation health');

package/bin/install.ts

@@ -6,7 +6,7 @@
  * Usage:
  *   npx tsx install.ts                # Universal (Node + tsx)
  *   bun install.ts                    # If bun is available
- *   GMTR_TOKEN=xxx npx tsx install.ts # Headless with token
+ *   GRAMATR_TOKEN=xxx npx tsx install.ts # Headless with token
  *   npx tsx install.ts --yes          # Non-interactive (auto-accept defaults)
  */
 
@@ -27,8 +27,8 @@ const HOME = process.env.HOME || process.env.USERPROFILE || '';
 const CLAUDE_DIR = join(HOME, '.claude');
 const CLAUDE_SETTINGS = join(CLAUDE_DIR, 'settings.json');
 const CLAUDE_JSON = join(HOME, '.claude.json');
-const CLIENT_DIR = join(HOME, 'gmtr-client');
-const GMTR_JSON = join(HOME, '.gmtr.json');
+const CLIENT_DIR = join(HOME, '.gramatr');
+const GMTR_JSON = join(HOME, '.gramatr.json');
 const SCRIPT_DIR = dirname(dirname(resolve(import.meta.filename || __filename)));
 const DEFAULT_URL = 'https://api.gramatr.com/mcp';
 
@@ -398,13 +398,13 @@ async function handleAuth(legacyToken: string): Promise<{ url: string; token: st
   const url = await prompt('gramatr server URL', DEFAULT_URL) || DEFAULT_URL;
 
   // Legacy aios token migration: if we cherry-picked a token from a prior
-  // aios install and there is no current ~/.gmtr.json token, seed it so the
+  // aios install and there is no current ~/.gramatr.json token, seed it so the
   // shared resolver picks it up.
   if (legacyToken && !existsSync(GMTR_JSON)) {
     try {
       writeFileSync(GMTR_JSON, `${JSON.stringify({ token: legacyToken }, null, 2)}\n`, 'utf8');
       try { chmodSync(GMTR_JSON, 0o600); } catch { /* ok */ }
-      log('OK Seeded ~/.gmtr.json from legacy aios installation token');
+      log('OK Seeded ~/.gramatr.json from legacy aios installation token');
     } catch { /* ignore */ }
   }
 
@@ -508,16 +508,16 @@ function updateClaudeSettings(url: string, token: string): void {
   cpSync(CLAUDE_SETTINGS, backup);
   log(`OK Backed up settings to ${basename(backup)}`);
 
-  const includeOptionalUx = process.env.GMTR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
+  const includeOptionalUx = process.env.GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
   const hooksConfig = buildClaudeHooksFile(CLIENT_DIR, { includeOptionalUx });
 
   const settings = readJson(CLAUDE_SETTINGS);
 
   // Env vars
   settings.env = settings.env || {};
-  settings.env.GMTR_DIR = CLIENT_DIR;
-  settings.env.GMTR_URL = url;
-  settings.env.PATH = `${HOME}/.gmtr/bin:/usr/local/bin:/usr/bin:/bin`;
+  settings.env.GRAMATR_DIR = CLIENT_DIR;
+  settings.env.GRAMATR_URL = url;
+  settings.env.PATH = `${HOME}/.gramatr/bin:/usr/local/bin:/usr/bin:/bin`;
   if (token) settings.env.AIOS_MCP_TOKEN = token;
 
   // Identity defaults (don't overwrite)
@@ -539,7 +539,7 @@ function updateClaudeSettings(url: string, token: string): void {
   if (includeOptionalUx) {
     log('OK   Optional Claude UX hooks enabled');
   } else {
-    log('OK   Thin-client hook set (set GMTR_ENABLE_OPTIONAL_CLAUDE_UX=1 for optional hooks)');
+    log('OK   Thin-client hook set (set GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX=1 for optional hooks)');
   }
 
   // Status line
@@ -564,7 +564,7 @@ function registerMcpServer(url: string, token: string): void {
   const backup = `${CLAUDE_JSON}.backup-${timestamp()}`;
   cpSync(CLAUDE_JSON, backup);
 
-  // Store token in ~/.gmtr.json
+  // Store token in ~/.gramatr.json
   if (token) {
     mergeJson(GMTR_JSON, (data) => ({
       ...data,
@@ -572,10 +572,10 @@ function registerMcpServer(url: string, token: string): void {
       token_updated_at: new Date().toISOString(),
     }));
     try { chmodSync(GMTR_JSON, 0o600); } catch { /* ok */ }
-    log('OK Token stored in ~/.gmtr.json (canonical source)');
+    log('OK Token stored in ~/.gramatr.json (canonical source)');
   }
 
-  // Write tool paths to ~/.gmtr.json
+  // Write tool paths to ~/.gramatr.json
   mergeJson(GMTR_JSON, (data) => ({
     ...data,
     jq_binary: which('jq') || '',
@@ -585,14 +585,14 @@ function registerMcpServer(url: string, token: string): void {
   // Register in ~/.claude.json
   mergeJson(CLAUDE_JSON, (data) => {
     data.env = data.env || {};
-    if (token) data.env.GMTR_TOKEN = token;
+    if (token) data.env.GRAMATR_TOKEN = token;
     delete data.env.AIOS_MCP_TOKEN;
 
     data.mcpServers = data.mcpServers || {};
     data.mcpServers.gramatr = {
       type: 'http',
       url,
-      headers: { Authorization: 'Bearer ${GMTR_TOKEN}' },
+      headers: { Authorization: 'Bearer ${GRAMATR_TOKEN}' },
       autoApprove: true,
     };
     return data;
@@ -624,10 +624,10 @@ function verify(url: string, token: string): boolean {
   // exploding at hook execution time. The hook-imports-shipped.test.ts
   // regression guard catches missing entries at PR review.
   for (const f of [
-    'hooks/GMTRToolTracker.hook.ts',
-    'hooks/GMTRPromptEnricher.hook.ts',
-    'hooks/GMTRRatingCapture.hook.ts',
-    'hooks/GMTRSecurityValidator.hook.ts',
+    'hooks/gramatr-tool-tracker.hook.ts',
+    'hooks/gramatr-prompt-enricher.hook.ts',
+    'hooks/gramatr-rating-capture.hook.ts',
+    'hooks/gramatr-security-validator.hook.ts',
     'hooks/lib/notify.ts',
     'core/routing.ts',
     'core/session.ts',
@@ -734,7 +734,7 @@ async function main(): Promise<void> {
     if (!token) {
       log('    2. Run /gmtr-login in Claude Code to authenticate');
     } else {
-      log('    2. Already authenticated (token found in ~/.gmtr.json)');
+      log('    2. Already authenticated (token found in ~/.gramatr.json)');
     }
     log('');
   } else {

package/bin/lib/config.ts

@@ -2,14 +2,14 @@
  * gramatr client config resolver (statusline refactor, #495).
  *
  * Single-purpose helper that returns the server URL + auth token with
- * NO reads of ~/.claude* or ~/gmtr-client/settings.json. This is the
+ * NO reads of ~/.claude* or ~/.gramatr/settings.json. This is the
  * statusline-specific config path; the richer installer auth lives in
  * core/auth.ts for a reason — this file must stay small and side-effect-free
  * so it can be loaded in a 2s shim without touching disk more than once.
  *
  * Resolution:
- *   URL   — GMTR_URL → ~/.gmtr.json.url → https://api.gramatr.com
- *   Token — GMTR_TOKEN → AIOS_MCP_TOKEN → ~/.gmtr.json.token → null
+ *   URL   — GRAMATR_URL → ~/.gramatr.json.url → https://api.gramatr.com
+ *   Token — GRAMATR_API_KEY → ~/.gramatr.json.token → null
  */
 import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
@@ -27,7 +27,7 @@ function getHome(): string {
 }
 
 function readGmtrJson(): Record<string, any> | null {
-  const path = join(getHome(), '.gmtr.json');
+  const path = join(getHome(), '.gramatr.json');
   if (!existsSync(path)) return null;
   try {
     return JSON.parse(readFileSync(path, 'utf8'));
@@ -40,15 +40,15 @@ export function getGramatrConfig(): GramatrConfig {
   const json = readGmtrJson();
 
   const rawUrl =
-    process.env.GMTR_URL ||
+    process.env.GRAMATR_URL ||
     (typeof json?.url === 'string' && json.url) ||
     DEFAULT_URL;
-  // GMTR_URL is conventionally the MCP endpoint (e.g. https://api.gramatr.com/mcp).
+  // GRAMATR_URL is conventionally the MCP endpoint (e.g. https://api.gramatr.com/mcp).
   // REST calls need the API base — strip a trailing /mcp segment.
   const url = (rawUrl as string).replace(/\/mcp\/?$/, '');
 
   const token =
-    process.env.GMTR_TOKEN ||
+    process.env.GRAMATR_TOKEN ||
     process.env.AIOS_MCP_TOKEN ||
     (typeof json?.token === 'string' && json.token) ||
     null;

package/bin/logout.ts

@@ -2,8 +2,8 @@
 /**
  * gramatr logout — Clear stored gramatr credentials (issue #484).
  *
- * Removes ~/.gmtr.json. With --keep-backup, renames it to
- * ~/.gmtr.json.bak.<timestamp> instead of deleting.
+ * Removes ~/.gramatr.json. With --keep-backup, renames it to
+ * ~/.gramatr.json.bak.<timestamp> instead of deleting.
  *
  * Not-logged-in is not an error: exits 0 with a clean message.
  */
@@ -13,7 +13,7 @@ import { homedir } from "os";
 import { join } from "path";
 
 function gmtrJsonPath(): string {
-  return join(process.env.HOME || process.env.USERPROFILE || homedir(), ".gmtr.json");
+  return join(process.env.HOME || process.env.USERPROFILE || homedir(), ".gramatr.json");
 }
 
 function log(msg: string = ""): void {
@@ -34,8 +34,8 @@ function showHelp(): void {
   log(`gramatr logout — Clear stored gramatr credentials
 
 Usage:
-  gramatr logout                Delete ~/.gmtr.json
-  gramatr logout --keep-backup  Rename to ~/.gmtr.json.bak.<timestamp> instead`);
+  gramatr logout                Delete ~/.gramatr.json
+  gramatr logout --keep-backup  Rename to ~/.gramatr.json.bak.<timestamp> instead`);
 }
 
 export function main(argv: string[] = process.argv.slice(2)): number {

package/bin/render-claude-hooks.ts

@@ -8,7 +8,7 @@ function main(): void {
     throw new Error('Usage: render-claude-hooks.ts <client-dir>');
   }
 
-  const includeOptionalUx = process.env.GMTR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
+  const includeOptionalUx = process.env.GRAMATR_ENABLE_OPTIONAL_CLAUDE_UX === '1';
   const hooks = buildClaudeHooksFile(clientDir, { includeOptionalUx });
   process.stdout.write(`${JSON.stringify(hooks.hooks, null, 2)}\n`);
 }

package/bin/uninstall.ts

@@ -5,7 +5,7 @@
  * Usage:
  *   bun uninstall.ts              # Interactive — confirms each step
  *   bun uninstall.ts --yes        # Non-interactive — uninstall everything
- *   bun uninstall.ts --keep-auth  # Keep ~/.gmtr.json (preserve login)
+ *   bun uninstall.ts --keep-auth  # Keep ~/.gramatr.json (preserve login)
  *   npx tsx uninstall.ts          # Without bun
  */
 
@@ -53,7 +53,7 @@ function removeGramatrFromJson(filePath: string, keys: string[]): boolean {
         delete data[key];
         changed = true;
       }
-      // Handle nested keys like "env.GMTR_TOKEN"
+      // Handle nested keys like "env.GRAMATR_TOKEN"
       if (key.includes('.')) {
         const [parent, child] = key.split('.');
         if (data[parent] && child in data[parent]) {
@@ -97,8 +97,8 @@ async function main(): Promise<void> {
   log('  ===================');
   log('');
 
-  const gmtrClient = join(HOME, 'gmtr-client');
-  const gmtrJson = join(HOME, '.gmtr.json');
+  const gmtrClient = join(HOME, '.gramatr');
+  const gmtrJson = join(HOME, '.gramatr.json');
   const gmtrDotDir = join(HOME, '.gmtr');
   const claudeSettings = join(HOME, '.claude', 'settings.json');
   const claudeJson = join(HOME, '.claude.json');
@@ -111,9 +111,9 @@ async function main(): Promise<void> {
 
   // Detect what's installed
   const installed: string[] = [];
-  if (existsSync(gmtrClient)) installed.push(`~/gmtr-client (${dirSize(gmtrClient)})`);
+  if (existsSync(gmtrClient)) installed.push(`~/.gramatr (${dirSize(gmtrClient)})`);
   if (existsSync(gmtrDotDir)) installed.push(`~/.gmtr/ (${dirSize(gmtrDotDir)})`);
-  if (existsSync(gmtrJson)) installed.push('~/.gmtr.json');
+  if (existsSync(gmtrJson)) installed.push('~/.gramatr.json');
   if (existsSync(claudeSettings)) installed.push('~/.claude/settings.json (hooks)');
   if (existsSync(claudeJson)) installed.push('~/.claude.json (MCP server)');
   if (existsSync(codexHooks)) installed.push('~/.codex/hooks.json');
@@ -136,10 +136,10 @@ async function main(): Promise<void> {
 
   log('');
 
-  // 1. Remove ~/gmtr-client (hooks, bin, skills, agents, tools)
+  // 1. Remove ~/.gramatr (hooks, bin, skills, agents, tools)
   if (existsSync(gmtrClient)) {
     rmSync(gmtrClient, { recursive: true, force: true });
-    log('  OK Removed ~/gmtr-client');
+    log('  OK Removed ~/.gramatr');
   }
 
   // 2. Remove ~/.gmtr/ (bun binary, PATH additions)
@@ -148,13 +148,13 @@ async function main(): Promise<void> {
     log('  OK Removed ~/.gmtr/');
   }
 
-  // 3. Remove ~/.gmtr.json (auth token) — unless --keep-auth
+  // 3. Remove ~/.gramatr.json (auth token) — unless --keep-auth
   if (existsSync(gmtrJson)) {
     if (KEEP_AUTH) {
-      log('  -- Kept ~/.gmtr.json (--keep-auth)');
+      log('  -- Kept ~/.gramatr.json (--keep-auth)');
     } else {
       rmSync(gmtrJson);
-      log('  OK Removed ~/.gmtr.json');
+      log('  OK Removed ~/.gramatr.json');
     }
   }
 
@@ -174,14 +174,14 @@ async function main(): Promise<void> {
           for (const [event, hooks] of Object.entries(settings.hooks)) {
             if (Array.isArray(hooks)) {
               settings.hooks[event] = (hooks as any[]).filter(
-                (h: any) => !h.command?.includes('gmtr-client') && !h.command?.includes('gramatr')
+                (h: any) => !h.command?.includes('.gramatr') && !h.command?.includes('gramatr')
               );
               if (settings.hooks[event].length === 0) delete settings.hooks[event];
             }
           }
           if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
         }
-        if (settings.statusLine?.command?.includes('gmtr-client')) {
+        if (settings.statusLine?.command?.includes('.gramatr')) {
           delete settings.statusLine;
         }
         writeFileSync(claudeSettings, JSON.stringify(settings, null, 2) + '\n');
@@ -194,7 +194,7 @@ async function main(): Promise<void> {
 
   // 5. Remove gramatr from ~/.claude.json (MCP server + env vars)
   if (existsSync(claudeJson)) {
-    const cleaned = removeGramatrFromJson(claudeJson, ['env.GMTR_TOKEN', 'env.AIOS_MCP_TOKEN']);
+    const cleaned = removeGramatrFromJson(claudeJson, ['env.GRAMATR_TOKEN', 'env.AIOS_MCP_TOKEN']);
     if (cleaned) log('  OK Removed gramatr MCP server + env vars from ~/.claude.json');
   }
 
@@ -242,7 +242,7 @@ async function main(): Promise<void> {
         for (const [event, eventHooks] of Object.entries(hooks.hooks)) {
           if (Array.isArray(eventHooks)) {
             hooks.hooks[event] = (eventHooks as any[]).filter(
-              (h: any) => !h.command?.includes('gmtr-client') && !h.command?.includes('gramatr')
+              (h: any) => !h.command?.includes('.gramatr') && !h.command?.includes('gramatr')
             );
             if (hooks.hooks[event].length === 0) delete hooks.hooks[event];
           }
@@ -278,7 +278,7 @@ async function main(): Promise<void> {
   log('  Uninstall complete.');
   log('  Restart Claude Code / Codex / Gemini CLI to apply changes.');
   if (KEEP_AUTH) {
-    log('  Auth token preserved in ~/.gmtr.json (use --token with next install).');
+    log('  Auth token preserved in ~/.gramatr.json (use --token with next install).');
   }
   log('');
 }

package/chatgpt/install.ts

@@ -64,7 +64,7 @@ async function main(): Promise<void> {
   // Step 2: Validate server connectivity
   log('');
   log('Step 2: Validating server connectivity...');
-  const serverUrl = process.env.GMTR_URL || DEFAULT_MCP_URL;
+  const serverUrl = process.env.GRAMATR_URL || DEFAULT_MCP_URL;
   const serverReachable = await validateServer(serverUrl);
   if (serverReachable) {
     log(`  OK Server reachable at ${serverUrl.replace(/\/mcp$/, '')}`);

package/codex/install.ts

@@ -47,7 +47,7 @@ export function main(): void {
     throw new Error('HOME is not set');
   }
 
-  const gmtrDir = process.env.GMTR_DIR || join(home, 'gmtr-client');
+  const gmtrDir = process.env.GRAMATR_DIR || join(home, '.gramatr');
   const codexHome = join(home, '.codex');
   const hooksPath = join(codexHome, 'hooks.json');
   const configPath = join(codexHome, 'config.toml');