sanook-cli 0.5.5 → 0.5.7

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.5.7
+
+### Local token usage ledger (ccusage-style)
+
+- **Persistent usage tracking** — every agent turn appends to `~/.sanook/usage/events.jsonl` with input/output/cache tokens, estimated cost, model, session id, and source (`repl`, `headless`, `gateway`, `subagent`, `plan`).
+- **`sanook usage`** — daily / weekly / monthly / session reports with ASCII tables and `--json` export (similar to [ccusage](https://ccusage.com/guide/getting-started)).
+- **Codex usage capture** — parse `turn.completed` token counts from Codex JSONL into the ledger.
+- **`/cost` / `/usage`** in REPL now points to `sanook usage daily` for full history.
+- Disable with `SANOOK_DISABLE_USAGE=1`.
+
+## 0.5.6
+
+### Install UX, second-brain wiring, session save, terminal visibility, Codex models
+
+- **`sanookai` CLI alias** — backward-compatible binary name alongside `sanook` (fixes Windows "sanookai not recognized" when docs/videos use the old name).
+- **Postinstall hints** — clarify global vs local install; suggest `npx sanook` / `npx sanookai` when not on PATH.
+- **Second-brain project link** — after setup brain wizard, auto-scaffold `Projects/<slug>/` for the current repo and create/link `SANOOK.md` project memory.
+- **Session save on exit** — Ctrl+C (empty prompt) or `/quit` saves the REPL session and writes a summarized note to `Sessions/` in the vault.
+- **Live agent status** — REPL shows Codex/Agent/Tool/Thinking status while work is in progress.
+- **Codex model picker** — delegate provider lists current Codex models (`gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`, legacy codex variants, spark).
+
 ## 0.5.5
 
 ### Hermes-style setup, dashboard, and terminal parity

package/dist/bin.js

@@ -132,6 +132,7 @@ usage:
   ${BRAND.cliName} --json "<task>"     headless, JSONL output (for CI/scripts)
   ${BRAND.cliName} sessions             list/resume-audit saved conversation sessions
   ${BRAND.cliName} insights             local usage/session insights
+  ${BRAND.cliName} usage [daily|...]    token/cost ledger (ccusage-style)
   ${BRAND.cliName} dump [--show-keys]   support snapshot (secrets redacted)
   ${BRAND.cliName} prompt-size [--json]  inspect prompt/context budget without calling a model
   ${BRAND.cliName} runtimes [--json]     inspect optional Python/Rust runtime surface
@@ -2317,6 +2318,17 @@ async function runSessions(args) {
     console.error(`ไม่รู้จัก: sessions ${action}\n${sessionUsage()}`);
     process.exit(1);
 }
+async function runUsage(args) {
+    const { parseUsageArgs, renderUsageReport, usageHelpText } = await import('./usage-cli.js');
+    const parsed = parseUsageArgs(args);
+    if (!parsed) {
+        console.log(usageHelpText());
+        if (args.length && !args.includes('-h') && !args.includes('--help'))
+            process.exit(2);
+        return;
+    }
+    console.log(await renderUsageReport(parsed));
+}
 async function runInsights(args) {
     const { parseInsightsArgs } = await import('./insights-args.js');
     const parsed = parseInsightsArgs(args);
@@ -4084,6 +4096,8 @@ async function main() {
         return runAuth(argv.slice(1));
     if (argv[0] === 'sessions' || argv[0] === 'session')
         return runSessions(argv.slice(1));
+    if (argv[0] === 'usage')
+        return runUsage(argv.slice(1));
     if (argv[0] === 'insights')
         return runInsights(argv.slice(1));
     if (argv[0] === 'memory' && ['log', 'stats', undefined].includes(argv[1]))

package/dist/brain-link.js

@@ -0,0 +1,73 @@
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { BRAND } from './brand.js';
+import { scaffoldProjectWorkspace } from './project-scaffold.js';
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Wire a freshly scaffolded vault to the current repo: Projects/<slug>/ + SANOOK.md memory stub. */
+export async function linkBrainToProject(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const brainPath = options.brainPath;
+    const title = options.title?.trim() || basename(cwd) || 'Project';
+    const today = options.today ?? new Date().toISOString().slice(0, 10);
+    const warnings = [];
+    const scaffold = await scaffoldProjectWorkspace({
+        brainPath,
+        title,
+        repoPath: cwd,
+        today,
+    });
+    if (!scaffold.ok && scaffold.skipped.length) {
+        warnings.push(...scaffold.warnings);
+    }
+    else if (scaffold.warnings.length) {
+        warnings.push(...scaffold.warnings);
+    }
+    const memoryFile = join(cwd, BRAND.memoryFileName);
+    let memoryCreated = false;
+    if (!(await exists(memoryFile))) {
+        const body = [
+            `# ${BRAND.productName} project memory`,
+            '',
+            `> Linked to second-brain vault: \`${brainPath}\``,
+            scaffold.ok || scaffold.slug ? `> Project workspace: \`Projects/${scaffold.slug}/\`` : '',
+            '',
+            '## Conventions',
+            '',
+            '- Decisions, gotchas, and preferences discovered in this repo belong here or in the vault.',
+            `- Session summaries are auto-written to \`Sessions/\` in the vault on exit (Ctrl+C / /quit).`,
+            '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+        await writeFile(memoryFile, `${body}\n`, 'utf8');
+        memoryCreated = true;
+    }
+    else {
+        try {
+            const current = await readFile(memoryFile, 'utf8');
+            if (!current.includes(brainPath)) {
+                await writeFile(memoryFile, `${current.trimEnd()}\n\n<!-- ${BRAND.productName} -->\nsecond-brain: ${brainPath}\nproject: Projects/${scaffold.slug}/\n`, 'utf8');
+            }
+        }
+        catch {
+            warnings.push(`Could not update existing ${BRAND.memoryFileName}`);
+        }
+    }
+    return {
+        ok: scaffold.ok || scaffold.skipped.length > 0,
+        brainPath,
+        projectSlug: scaffold.slug,
+        projectRelDir: scaffold.relDir,
+        memoryFile,
+        memoryCreated,
+        warnings,
+    };
+}

package/dist/brand.js

@@ -24,6 +24,7 @@ export const BRAND_ENV = {
     disablePersistence: 'SANOOK_DISABLE_PERSISTENCE',
     disableUpdateCheck: 'SANOOK_DISABLE_UPDATE_CHECK',
     disableWorklog: 'SANOOK_DISABLE_WORKLOG',
+    disableUsageLedger: 'SANOOK_DISABLE_USAGE',
     trustProject: 'SANOOK_TRUST_PROJECT',
 };
 export function appHomePath(...parts) {
@@ -45,3 +46,6 @@ export function persistenceEnabled() {
 export function worklogEnabled() {
     return !envFlag(BRAND_ENV.disableWorklog);
 }
+export function usageLedgerEnabled() {
+    return persistenceEnabled() && !envFlag(BRAND_ENV.disableUsageLedger);
+}

package/dist/commands.js

@@ -282,7 +282,10 @@ export function parseCommand(input, ctx) {
             return { handled: true, action: 'rewind' };
         case 'cost':
         case 'usage':
-            return { handled: true, message: ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)' };
+            return {
+                handled: true,
+                message: `${ctx.costSummary ?? '(ยังไม่มี usage รอบนี้)'}\n→ ${BRAND.cliName} usage daily`,
+            };
         case 'insights': {
             const parsed = parseInsightsArgs(args);
             if (parsed === null)

package/dist/config.js

@@ -4,9 +4,12 @@ import { join } from 'node:path';
 import { appHomePath, appProjectPath, BRAND } from './brand.js';
 import { projectRoot, projectTrustStatus } from './trust.js';
 import { registerPricing } from './cost.js';
-export const CONFIG_DIR = appHomePath();
-const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
-const AUTH_PATH = join(CONFIG_DIR, 'auth.json'); // API keys (chmod 0600)
+export function configHomeDir() {
+    return appHomePath();
+}
+function authPath() {
+    return join(configHomeDir(), 'auth.json');
+}
 const AUTH_ENV_VAR_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const RESERVED_AUTH_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 const PricingKeySchema = z.string().regex(/^[^:\s]+:\S+$/, 'key ต้องเป็น provider:model');
@@ -102,6 +105,9 @@ export async function agentTuning() {
     return { cacheTtl, thinkingBudget, compaction, contextCompression, summaryModel };
 }
 const warnedBadConfigKeys = new Set();
+function globalConfigPath() {
+    return join(configHomeDir(), 'config.json');
+}
 /**
  * Validate the merged config, but degrade gracefully: a malformed strict field (bad model/maxSteps/
  * permissionMode/budgetUsd/pricing in a hand-edited config.json) is dropped to its default with a
@@ -153,7 +159,7 @@ function sanitizeUntrustedProjectConfig(cfg) {
  * (config flat — shallow merge พอ; strip undefined ใน overrides กัน override ทับ default)
  */
 export async function loadConfig(overrides = {}, cwd = process.cwd()) {
-    const global = await readJson(CONFIG_PATH);
+    const global = await readJson(globalConfigPath());
     const root = await projectRoot(cwd);
     const projectRaw = await readJson(appProjectPath(root, 'config.json'));
     const trust = await projectTrustStatus(root);
@@ -207,7 +213,7 @@ export function parsePricingOverride(raw) {
 /** ครั้งแรกที่รัน (ยังไม่มี global config) → ต้องทำ setup wizard */
 export async function isFirstRun() {
     try {
-        await readFile(CONFIG_PATH, 'utf8');
+        await readFile(globalConfigPath(), 'utf8');
         return false;
     }
     catch {
@@ -216,32 +222,32 @@ export async function isFirstRun() {
 }
 /** บันทึก global config (model/provider/locale ที่เลือกตอน setup) */
 export async function saveGlobalConfig(cfg) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, ...cfg }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, ...cfg }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** บันทึก path ของ second-brain workspace ลง global config (merge — ไม่ทับ field อื่น) */
 export async function saveBrainPath(path) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, brainPath: path }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, brainPath: path }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** อ่าน config.json ดิบ (ไม่ apply default/schema) — สำหรับ `sanook config` */
 export async function readGlobalConfigRaw() {
-    return readJson(CONFIG_PATH);
+    return readJson(globalConfigPath());
 }
 /** path ของ auth.json (ใช้โชว์ใน CLI เท่านั้น; ห้าม print raw secret) */
 export function authConfigPath() {
-    return AUTH_PATH;
+    return authPath();
 }
 function isSafeAuthEnvVarName(name) {
     return AUTH_ENV_VAR_RE.test(name) && !RESERVED_AUTH_KEYS.has(name);
 }
 /** อ่าน auth.json ดิบแบบกรองเฉพาะ string values — caller ต้อง redact ก่อนโชว์ */
 export async function readStoredAuthRaw() {
-    const raw = await readJson(AUTH_PATH);
+    const raw = await readJson(authPath());
     const auth = {};
     for (const [k, v] of Object.entries(raw)) {
         if (isSafeAuthEnvVarName(k) && typeof v === 'string')
@@ -251,44 +257,44 @@ export async function readStoredAuthRaw() {
 }
 /** merge patch ลง config.json (สำหรับ `sanook config set`) */
 export async function patchGlobalConfig(patch) {
-    await mkdir(CONFIG_DIR, { recursive: true });
-    const existing = await readJson(CONFIG_PATH);
-    await writeFile(CONFIG_PATH, `${JSON.stringify({ ...existing, ...patch }, null, 2)}\n`, { mode: 0o600 });
-    await chmod(CONFIG_PATH, 0o600).catch(() => { });
+    await mkdir(configHomeDir(), { recursive: true });
+    const existing = await readJson(globalConfigPath());
+    await writeFile(globalConfigPath(), `${JSON.stringify({ ...existing, ...patch }, null, 2)}\n`, { mode: 0o600 });
+    await chmod(globalConfigPath(), 0o600).catch(() => { });
 }
 /** บันทึก API key ลง ~/.sanook/auth.json (chmod 0600) + set env ทันทีสำหรับ session นี้ */
 export async function saveKey(envVar, key) {
     if (!isSafeAuthEnvVarName(envVar))
         throw new Error(`env var ไม่ถูกต้อง: ${envVar}`);
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     auth[envVar] = key;
-    await writeFile(AUTH_PATH, `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600); // เจ้าของอ่าน/เขียนเท่านั้น
+    await writeFile(authPath(), `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
+    await chmod(authPath(), 0o600); // เจ้าของอ่าน/เขียนเท่านั้น
     process.env[envVar] = key;
 }
 /** ลบ key ที่ Sanook เก็บไว้ใน auth.json (ไม่แตะ env จริงของ shell ภายนอก) */
 export async function removeStoredKey(envVar) {
     if (!isSafeAuthEnvVarName(envVar))
         return false;
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     if (!Object.prototype.hasOwnProperty.call(auth, envVar))
         return false;
     delete auth[envVar];
-    await writeFile(AUTH_PATH, `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600).catch(() => { });
+    await writeFile(authPath(), `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
+    await chmod(authPath(), 0o600).catch(() => { });
     delete process.env[envVar];
     return true;
 }
 /** ล้าง auth.json ที่ Sanook เก็บไว้ทั้งหมด */
 export async function clearStoredAuth() {
-    await mkdir(CONFIG_DIR, { recursive: true });
+    await mkdir(configHomeDir(), { recursive: true });
     const auth = await readStoredAuthRaw();
     for (const envVar of Object.keys(auth))
         delete process.env[envVar];
-    await writeFile(AUTH_PATH, '{}\n', { mode: 0o600 });
-    await chmod(AUTH_PATH, 0o600).catch(() => { });
+    await writeFile(authPath(), '{}\n', { mode: 0o600 });
+    await chmod(authPath(), 0o600).catch(() => { });
 }
 /** โหลด key จาก auth.json เข้า env ตอน boot (ไม่ override env ที่ตั้งไว้แล้ว) */
 export async function loadKeysIntoEnv() {

package/dist/cost.js

@@ -12,6 +12,14 @@ export const PRICING = {
     'openai:gpt-5.5': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
     'openai:gpt-5.4-mini': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
     'openai:gpt-5.3-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    // OpenAI Codex delegate (ChatGPT plan — token counts are real; cost is estimated from API list price)
+    'codex:gpt-5.5': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.4': { input: 2.5, output: 15, cacheWrite: 2.5, cacheRead: 0.25 },
+    'codex:gpt-5.4-mini': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
+    'codex:gpt-5.3-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.2-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5-codex': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.125 },
+    'codex:gpt-5.3-codex-spark': { input: 0.25, output: 2, cacheWrite: 0.25, cacheRead: 0.025 },
     // Google Gemini (≤200k context tier)
     'google:gemini-2.5-pro': { input: 1.25, output: 10, cacheWrite: 1.25, cacheRead: 0.31 },
     'google:gemini-2.5-flash': { input: 0.3, output: 2.5, cacheWrite: 0.3, cacheRead: 0.075 },
@@ -147,4 +155,16 @@ export class CostMeter {
         const budget = this.budgetUsd != null ? ` / budget $${this.budgetUsd}` : '';
         return `tokens: ${total} (in ${this.inTok} · out ${this.outTok} · cache-read ${this.cacheReadTok} · cache-write ${this.cacheWriteTok}) · cost ${cost}${budget}`;
     }
+    snapshot() {
+        return {
+            specKey: this.specKey,
+            inputTokens: this.inTok,
+            outputTokens: this.outTok,
+            cacheReadTokens: this.cacheReadTok,
+            cacheWriteTokens: this.cacheWriteTok,
+            totalTokens: this.inTok + this.outTok + this.cacheReadTok + this.cacheWriteTok,
+            costUsd: this.spent,
+            hasPricing: this.hasPricing,
+        };
+    }
 }

package/dist/gateway/session.js

@@ -172,6 +172,10 @@ async function runAndSaveGatewayTurn(opts, existing, prompt, history, model) {
         maxSteps: opts.maxSteps ?? 20,
         budgetUsd: opts.budgetUsd,
         permissionMode: opts.permissionMode ?? 'ask',
+        usageMeta: {
+            sessionId: `${opts.platform}:${opts.target}`,
+            source: 'gateway',
+        },
     });
     await saveGatewayState(opts, existing, model, messages);
     return { text, messages, suppressDelivery: shouldSuppressDelivery(text) };

package/dist/loop.js

@@ -19,6 +19,7 @@ import { agentTuning, loadConfig } from './config.js';
 import { BRAND, envFlag } from './brand.js';
 import { semanticRecallHits } from './knowledge.js';
 import { personalityPrompt } from './personality.js';
+import { recordAgentUsage, usageFromCodexPayload } from './usage-ledger.js';
 // auto-compact เมื่อ context ใกล้เต็ม — conservative (safe สำหรับ model 200K, เผื่อ output)
 const AUTO_COMPACT_TOKENS = 120_000;
 const OS_LABEL = process.platform === 'win32'
@@ -148,7 +149,6 @@ async function maybeWrapWithHeadroom(model) {
  * แกน harness — agent loop: LLM -> tool -> result -> loop จนเสร็จ
  * multi-provider (BYOK) ผ่าน registry + cost meter + budget cap
  */
-/** delegate path — spawn official codex CLI (ChatGPT plan quota) แทน SDK loop */
 async function runDelegate(opts) {
     const { runCodex } = await import('./providers/codex.js');
     const meter = new CostMeter(specKey(opts.model), opts.budgetUsd, agentContext.getStore()?.sharedBudget);
@@ -173,10 +173,11 @@ async function runDelegate(opts) {
     // sandbox: plan/ask-mode → read-only (สกัด approval รายไฟล์ของ codex ไม่ได้ จึงไม่ให้แก้);
     // auto (--yes / config auto) → workspace-write เพื่อให้ codex แก้ไฟล์ได้จริง (ไม่งั้นเป็น coding agent ที่แก้อะไรไม่ได้)
     const sandbox = opts.planMode || (opts.permissionMode ?? 'ask') === 'ask' ? 'read-only' : 'workspace-write';
+    opts.onEvent?.({ type: 'status', detail: `Codex · ${model} · ${sandbox}` });
     let text = '';
     const out = await runCodex({
         prompt,
-        model: model === 'gpt-5-codex' ? undefined : model,
+        model: model === PROVIDERS.codex.models.default ? undefined : model,
         sandbox,
         cwd: opts.cwd, // worktree isolation ของ sub-agent
         signal: opts.signal,
@@ -190,6 +191,9 @@ async function runDelegate(opts) {
                     opts.onEvent?.({ type: 'text', text: delta });
             }
             else if (e.type === 'usage') {
+                const parsed = usageFromCodexPayload(e.usage);
+                if (parsed)
+                    meter.add(parsed);
                 opts.onEvent?.({ type: 'finish', detail: 'codex · ChatGPT quota' });
             }
         },
@@ -200,7 +204,26 @@ async function runDelegate(opts) {
         { role: 'user', content: opts.prompt },
         { role: 'assistant', content: text },
     ];
-    return { messages, text, cost: meter };
+    return finishAgentRun(opts, { messages, text, cost: meter });
+}
+function inferUsageSource(opts) {
+    if (opts.usageMeta?.source)
+        return opts.usageMeta.source;
+    if ((opts.subagentDepth ?? 0) > 0)
+        return 'subagent';
+    if (opts.planMode)
+        return 'plan';
+    return 'headless';
+}
+function finishAgentRun(opts, result) {
+    recordAgentUsage({
+        model: opts.model,
+        cost: result.cost,
+        cwd: opts.cwd ?? agentCwd(),
+        sessionId: opts.usageMeta?.sessionId,
+        source: inferUsageSource(opts),
+    });
+    return result;
 }
 export async function runAgent(opts) {
     // context ผ่าน AsyncLocalStorage (ไม่ใช่ process.env global) → parallel sub-agent ไม่ชนกัน
@@ -213,6 +236,7 @@ export async function runAgent(opts) {
     if (PROVIDERS[parseSpec(opts.model).provider]?.kind === 'delegate') {
         return runDelegate(opts);
     }
+    opts.onEvent?.({ type: 'status', detail: `Agent · ${opts.model}` });
     const rawModel = resolveModel(opts.model); // throws ถ้าไม่มี key / provider ผิด
     let meter = new CostMeter(specKey(opts.model), opts.budgetUsd, sharedBudget);
     // โหลด context: auto-memory + skills + git state + repo map + project SANOOK.md → system prompt
@@ -355,14 +379,17 @@ export async function runAgent(opts) {
                     opts.onEvent?.({ type: 'text', text: part.text });
                     break;
                 case 'reasoning-delta':
+                    opts.onEvent?.({ type: 'status', detail: 'Thinking…' });
                     opts.onEvent?.({ type: 'reasoning', text: part.text });
                     break;
                 case 'tool-call':
                     if (isMutatingTool(part.toolName))
                         sideEffectToolSeen = true;
+                    opts.onEvent?.({ type: 'status', detail: `Tool · ${part.toolName}` });
                     opts.onEvent?.({ type: 'tool-call', tool: part.toolName, detail: part.input });
                     break;
                 case 'tool-result':
+                    opts.onEvent?.({ type: 'status', detail: `Done · ${part.toolName}` });
                     opts.onEvent?.({ type: 'tool-result', tool: part.toolName, detail: part.output });
                     break;
                 case 'error':
@@ -409,5 +436,5 @@ export async function runAgent(opts) {
         throw new Error(cleanProviderError(streamError));
     const response = await result.response;
     // คืน history เต็ม (conversation + response messages) — ไม่รวม system (กัน user turn เก่าหาย + ไม่ save system ซ้ำ)
-    return { messages: [...conversation, ...response.messages], text, cost: meter };
+    return finishAgentRun(opts, { messages: [...conversation, ...response.messages], text, cost: meter });
 }

package/dist/providers/registry.js

@@ -134,7 +134,17 @@ export const PROVIDERS = {
         requiresKey: false,
         localPlaceholderKey: 'codex',
         keyFormat: null,
-        models: { default: 'gpt-5-codex', codex: 'gpt-5-codex' },
+        models: {
+            default: 'gpt-5.5',
+            codex: 'gpt-5.5',
+            '5.5': 'gpt-5.5',
+            '5.4': 'gpt-5.4',
+            '5.4-mini': 'gpt-5.4-mini',
+            '5.3-codex': 'gpt-5.3-codex',
+            '5.2-codex': 'gpt-5.2-codex',
+            '5-codex': 'gpt-5-codex',
+            spark: 'gpt-5.3-codex-spark',
+        },
         create: () => {
             throw new Error('codex เป็น delegate provider — ใช้ผ่าน codex subprocess ไม่ใช่ Vercel AI SDK');
         },

package/dist/session-brain.js

@@ -0,0 +1,103 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { BRAND, persistenceEnabled } from './brand.js';
+import { createBrainNote } from './brain-new.js';
+import { getBrainPath } from './memory.js';
+import { PROVIDERS, parseSpec } from './providers/registry.js';
+import { makeSummarizer } from './summarize.js';
+import { distilledFactsFromMessages } from './session-distill.js';
+import { saveSession } from './session.js';
+function transcriptFromTurns(turns) {
+    return turns
+        .filter((t) => t.role === 'user' || t.role === 'assistant')
+        .map((t) => `${t.role === 'user' ? 'User' : 'Assistant'}: ${t.text.trim()}`)
+        .filter((line) => line.length > 8)
+        .join('\n\n');
+}
+function sessionTitleFromHistory(history) {
+    const firstUser = history.find((t) => t.role === 'user')?.text.trim();
+    if (!firstUser)
+        return 'repl session';
+    const cleaned = firstUser.replace(/^\/\w+\s*/, '').trim();
+    return cleaned.split(/\s+/).slice(0, 8).join(' ').slice(0, 72) || 'repl session';
+}
+function injectSessionSummary(template, summary, facts) {
+    const summaryBlock = [summary.trim(), facts.length ? `\n### Key facts\n${facts.map((f) => `- ${f}`).join('\n')}` : '']
+        .filter(Boolean)
+        .join('\n');
+    if (/^## Summary\s*$/m.test(template)) {
+        return template.replace(/^## Summary\s*$/m, `## Summary\n\n${summaryBlock}`);
+    }
+    return `${template.trimEnd()}\n\n## Summary\n\n${summaryBlock}\n`;
+}
+async function summarizeSession(model, transcript, messages) {
+    const provider = parseSpec(model).provider;
+    if (PROVIDERS[provider]?.kind !== 'delegate' && transcript.trim().length > 40) {
+        try {
+            const text = await makeSummarizer(model)(transcript);
+            if (text.trim())
+                return text.trim();
+        }
+        catch {
+            // fall through to heuristic distill
+        }
+    }
+    const facts = distilledFactsFromMessages(messages);
+    if (facts.length)
+        return facts.map((f) => `- ${f}`).join('\n');
+    const lines = transcript.split('\n\n').slice(-6);
+    return lines.length ? lines.join('\n\n') : 'Session ended with no durable transcript.';
+}
+/** Persist REPL session + write a Sessions/ note in the configured second-brain vault. */
+export async function finalizeReplSession(options) {
+    const hasConversation = options.messages.length > 0 || options.history.some((t) => t.role === 'user' || t.role === 'assistant');
+    if (!hasConversation || !persistenceEnabled()) {
+        return { sessionSaved: false };
+    }
+    const now = new Date().toISOString();
+    const session = {
+        id: options.sessionId,
+        title: sessionTitleFromHistory(options.history),
+        created: options.sessionCreated,
+        updated: now,
+        model: options.model,
+        cwd: options.cwd,
+        messages: options.messages,
+    };
+    await saveSession(session);
+    const brainPath = await getBrainPath();
+    if (!brainPath)
+        return { sessionSaved: true };
+    const transcript = transcriptFromTurns(options.history);
+    const summary = await summarizeSession(options.model, transcript, options.messages);
+    const title = sessionTitleFromHistory(options.history);
+    const slugSuffix = options.sessionId.slice(-6);
+    const today = now.slice(0, 10);
+    const output = `Sessions/${today}-${slugSuffix}-session.md`;
+    const report = await createBrainNote({
+        brainPath,
+        type: 'session',
+        title,
+        output,
+        force: true,
+        today,
+    });
+    if (!report.ok || !report.path)
+        return { sessionSaved: true };
+    const facts = distilledFactsFromMessages(options.messages);
+    const raw = await readFile(report.path, 'utf8');
+    const next = injectSessionSummary(raw, summary, facts.slice(0, 8));
+    await writeFile(report.path, next, 'utf8');
+    return {
+        sessionSaved: true,
+        brainNoteRel: report.relPath,
+        brainNotePath: report.path,
+    };
+}
+export function formatFinalizeMessage(result) {
+    if (!result.sessionSaved)
+        return undefined;
+    if (result.brainNoteRel) {
+        return `${BRAND.cliName}: session saved · second-brain → [[${result.brainNoteRel.replace(/\.md$/i, '')}]]`;
+    }
+    return `${BRAND.cliName}: session saved`;
+}

package/dist/ui/app.js

@@ -6,6 +6,7 @@ import { Box, Text, useApp, useInput, useStdout } from 'ink';
 import { homedir } from 'node:os';
 import { BUILTIN_COMMANDS, HELP_TEXT, expandCustomCommand, loadCustomCommands, parseCommand, parseSlashInvocation, } from '../commands.js';
 import { runAgent } from '../loop.js';
+import { finalizeReplSession, formatFinalizeMessage } from '../session-brain.js';
 import { saveSession, newSessionId, listSessions, removeSession, renameSession } from '../session.js';
 import { TOOL_CATALOG } from '../tool-catalog.js';
 import { getBrainPath, appendBrainWorklog } from '../memory.js';
@@ -53,6 +54,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
     });
     const [streaming, setStreaming] = useState('');
     const [thinking, setThinking] = useState('');
+    const [agentStatus, setAgentStatus] = useState('');
     const [toolTrail, setToolTrail] = useState([]);
     const [busy, setBusy] = useState(false);
     const [model, setModel] = useState(initialModel);
@@ -74,6 +76,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
     const msgsRef = useRef(initialHistory ?? []); // conversation จริงสำหรับ LLM (สะสมข้ามรอบ)
     const sessionId = useRef(newSessionId());
     const sessionCreated = useRef(new Date().toISOString());
+    const exitingRef = useRef(false);
     const approvalResolve = useRef(null);
     const replHistory = useRef(loadHistory()); // prompt เก่า (persist) สำหรับ ↑/↓
     const checkpoints = useRef([]);
@@ -259,6 +262,26 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
         setCompletionIndex(0);
         return true;
     };
+    const requestExit = () => {
+        if (exitingRef.current)
+            return;
+        exitingRef.current = true;
+        void finalizeReplSession({
+            sessionId: sessionId.current,
+            sessionCreated: sessionCreated.current,
+            model,
+            cwd,
+            messages: msgsRef.current,
+            history: history.map((turn) => ({ role: turn.role, text: turn.text })),
+        })
+            .then((result) => {
+            const note = formatFinalizeMessage(result);
+            if (note)
+                process.stderr.write(`\n${note}\n`);
+            exit();
+        })
+            .catch(() => exit());
+    };
     // /diff /undo — git-backed (execFile ไม่ผ่าน shell)
     async function runGit(args, label) {
         try {
@@ -817,7 +840,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
             if (editor.value)
                 editor.reset(); // Ctrl+C ครั้งแรก = ล้างบรรทัด, ว่างแล้ว = ออก
             else
-                exit();
+                requestExit();
         }
     });
     /** ย้อน 1 turn — คืนไฟล์ (git, recoverable) + ตัดบทสนทนากลับ */
@@ -910,7 +933,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
         if (cmd.handled) {
             addTurn('user', displayText);
             if (cmd.action === 'quit')
-                return exit();
+                return requestExit();
             if (cmd.action === 'clear') {
                 msgsRef.current = [];
                 checkpoints.current = [];
@@ -1023,6 +1046,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
         resetLiveToolTrail();
         resetLiveThinking();
         setStreaming('');
+        setAgentStatus('Starting…');
         setBusy(true);
         let buf = '';
         let reasoningBuf = '';
@@ -1039,8 +1063,13 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
                 permissionMode,
                 approve: requestApproval,
                 signal: ac.signal,
+                usageMeta: { sessionId: sessionId.current, source: 'repl' },
                 onEvent: (e) => {
-                    if (e.type === 'text') {
+                    if (e.type === 'status' && typeof e.detail === 'string') {
+                        setAgentStatus(e.detail);
+                    }
+                    else if (e.type === 'text') {
+                        setAgentStatus((prev) => (prev.startsWith('Codex') || prev.startsWith('Agent') ? 'Writing…' : prev));
                         buf += e.text ?? '';
                         const now = Date.now();
                         if (now - lastFlush > 80) {
@@ -1103,6 +1132,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
         }
         finally {
             setStreaming('');
+            setAgentStatus('');
             resetLiveThinking();
             resetLiveToolTrail();
             setBusy(false);
@@ -1122,7 +1152,7 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
     const transcriptLimit = transcriptWindowSize(stdout?.rows);
     const transcriptView = getTranscriptWindow(history.length, transcriptLimit, transcriptScroll);
     const visibleHistory = history.slice(transcriptView.start, transcriptView.end);
-    return (_jsxs(Box, { flexDirection: "column", children: [history.length === 0 ? (_jsxs(_Fragment, { children: [_jsx(Banner, { columns: columns, model: model, mode: permissionMode === 'ask' ? 'ask' : 'auto', signals: bannerSignals }), _jsx(SessionPanel, { columns: columns, cwd: cwd, mcp: startupReadiness.mcp, model: model, mode: permissionMode === 'ask' ? 'ask' : 'auto', skills: startupReadiness.skills })] })) : null, transcriptView.showOlder ? (_jsxs(Text, { dimColor: true, children: ["\u2026 ", transcriptView.start, " older turns \u00B7 PgUp/Ctrl+U scroll \u00B7 PgDn/Ctrl+D newer"] })) : null, visibleHistory.map((turn) => (_jsx(TurnView, { columns: columns, thinkingMode: thinkingMode, toolTrailMode: toolTrailMode, turn: turn }, `${historyResetKey}-${turn.id}`))), transcriptView.showNewer ? (_jsxs(Text, { dimColor: true, children: ["\u2026 ", transcriptView.scrollFromBottom, " newer turns hidden \u00B7 PgDn/Ctrl+D to catch up"] })) : null, thinkingView.length ? _jsx(ThinkingView, { columns: columns, mode: thinkingMode, text: thinking }) : null, streaming ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(StreamingMarkdownText, { columns: columns, text: streaming }) })) : null, toolTrailView.length ? (_jsx(ToolTrailView, { columns: columns, items: toolTrail, mode: toolTrailMode })) : null, _jsx(FloatingOverlay, { columns: columns, overlay: overlay, pageSize: pagerPageSize }), _jsx(CompletionOverlay, { columns: columns, items: completions, selected: selectedCompletion }), queued.length ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["queued (", queued.length, ") \u00B7 \u2191\u2193 select \u00B7 Ctrl+X delete \u00B7 Esc clears"] }), queueWindow.showLead ? _jsx(Text, { dimColor: true, children: " \u2026" }) : null, queued.slice(queueWindow.start, queueWindow.end).map((q, i) => (_jsxs(Text, { color: queueWindow.start + i === activeQueueIndex ? 'yellow' : undefined, dimColor: queueWindow.start + i !== activeQueueIndex, children: [queueWindow.start + i === activeQueueIndex ? '›' : ' ', " ", queueWindow.start + i + 1, ".", ' ', compactPreview(q, Math.max(16, columns - 10))] }, `${queueWindow.start + i}-${q.slice(0, 16)}`))), queueWindow.showTail ? _jsxs(Text, { dimColor: true, children: ["  \u2026and ", queued.length - queueWindow.end, " more"] }) : null] })) : null, approvalReq ? (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: ["\u0E2D\u0E19\u0E38\u0E21\u0E31\u0E15\u0E34\u0E23\u0E31\u0E19 ", approvalReq.tool, "?"] }), _jsx(Text, { dimColor: true, children: approvalReq.summary }), _jsx(Text, { dimColor: true, children: "y = \u0E23\u0E31\u0E19 \u00B7 n = \u0E1B\u0E0F\u0E34\u0E40\u0E2A\u0E18" })] })) : (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: busy ? 'gray' : 'blue', paddingX: 1, children: [_jsx(Text, { color: busy ? 'gray' : 'cyan', children: busy ? '· ' : '› ' }), _jsx(InputView, { value: editor.value, cursor: editor.cursor, busy: busy })] })), _jsx(Text, { dimColor: true, children: footerStatus({
+    return (_jsxs(Box, { flexDirection: "column", children: [history.length === 0 ? (_jsxs(_Fragment, { children: [_jsx(Banner, { columns: columns, model: model, mode: permissionMode === 'ask' ? 'ask' : 'auto', signals: bannerSignals }), _jsx(SessionPanel, { columns: columns, cwd: cwd, mcp: startupReadiness.mcp, model: model, mode: permissionMode === 'ask' ? 'ask' : 'auto', skills: startupReadiness.skills })] })) : null, transcriptView.showOlder ? (_jsxs(Text, { dimColor: true, children: ["\u2026 ", transcriptView.start, " older turns \u00B7 PgUp/Ctrl+U scroll \u00B7 PgDn/Ctrl+D newer"] })) : null, visibleHistory.map((turn) => (_jsx(TurnView, { columns: columns, thinkingMode: thinkingMode, toolTrailMode: toolTrailMode, turn: turn }, `${historyResetKey}-${turn.id}`))), transcriptView.showNewer ? (_jsxs(Text, { dimColor: true, children: ["\u2026 ", transcriptView.scrollFromBottom, " newer turns hidden \u00B7 PgDn/Ctrl+D to catch up"] })) : null, thinkingView.length ? _jsx(ThinkingView, { columns: columns, mode: thinkingMode, text: thinking }) : null, streaming ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(StreamingMarkdownText, { columns: columns, text: streaming }) })) : null, toolTrailView.length ? (_jsx(ToolTrailView, { columns: columns, items: toolTrail, mode: toolTrailMode })) : null, _jsx(FloatingOverlay, { columns: columns, overlay: overlay, pageSize: pagerPageSize }), _jsx(CompletionOverlay, { columns: columns, items: completions, selected: selectedCompletion }), queued.length ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: ["queued (", queued.length, ") \u00B7 \u2191\u2193 select \u00B7 Ctrl+X delete \u00B7 Esc clears"] }), queueWindow.showLead ? _jsx(Text, { dimColor: true, children: " \u2026" }) : null, queued.slice(queueWindow.start, queueWindow.end).map((q, i) => (_jsxs(Text, { color: queueWindow.start + i === activeQueueIndex ? 'yellow' : undefined, dimColor: queueWindow.start + i !== activeQueueIndex, children: [queueWindow.start + i === activeQueueIndex ? '›' : ' ', " ", queueWindow.start + i + 1, ".", ' ', compactPreview(q, Math.max(16, columns - 10))] }, `${queueWindow.start + i}-${q.slice(0, 16)}`))), queueWindow.showTail ? _jsxs(Text, { dimColor: true, children: ["  \u2026and ", queued.length - queueWindow.end, " more"] }) : null] })) : null, approvalReq ? (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: ["\u0E2D\u0E19\u0E38\u0E21\u0E31\u0E15\u0E34\u0E23\u0E31\u0E19 ", approvalReq.tool, "?"] }), _jsx(Text, { dimColor: true, children: approvalReq.summary }), _jsx(Text, { dimColor: true, children: "y = \u0E23\u0E31\u0E19 \u00B7 n = \u0E1B\u0E0F\u0E34\u0E40\u0E2A\u0E18" })] })) : (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: busy ? 'gray' : 'blue', paddingX: 1, children: [_jsx(Text, { color: busy ? 'gray' : 'cyan', children: busy ? '· ' : '› ' }), _jsx(InputView, { value: editor.value, cursor: editor.cursor, busy: busy, agentStatus: agentStatus, toolTrail: toolTrail })] })), _jsx(Text, { dimColor: true, children: footerStatus({
                     branch: gitBranch,
                     backgroundTaskCount: bgTaskCount,
                     busy,
@@ -1138,9 +1168,12 @@ export function App({ initialModel, fallbackModel, budgetUsd, permissionMode = '
                 }) })] }));
 }
 /** input ที่มี cursor (inverse) + placeholder — minimal; รับ input ได้แม้ busy (ต่อคิว) */
-function InputView({ value, cursor, busy }) {
-    if (busy && !value)
-        return _jsx(Text, { dimColor: true, children: "\u0E01\u0E33\u0E25\u0E31\u0E07\u0E17\u0E33\u0E07\u0E32\u0E19\u2026 Esc/Ctrl+C \u0E2B\u0E22\u0E38\u0E14 \u00B7 \u0E1E\u0E34\u0E21\u0E1E\u0E4C\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E15\u0E48\u0E2D\u0E04\u0E34\u0E27 (\u23CE)" });
+function InputView({ value, cursor, busy, agentStatus, toolTrail, }) {
+    if (busy && !value) {
+        const runningTool = toolTrail?.find((item) => item.status === 'running');
+        const detail = agentStatus || (runningTool ? `Tool · ${runningTool.name}` : 'Working…');
+        return (_jsxs(Text, { dimColor: true, children: [detail, " \u00B7 Esc/Ctrl+C \u0E2B\u0E22\u0E38\u0E14 \u00B7 \u0E1E\u0E34\u0E21\u0E1E\u0E4C\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E15\u0E48\u0E2D\u0E04\u0E34\u0E27 (\u23CE)"] }));
+    }
     if (!busy && !value)
         return _jsx(Text, { dimColor: true, children: "\u0E16\u0E32\u0E21\u0E2D\u0E30\u0E44\u0E23\u0E01\u0E47\u0E44\u0E14\u0E49 \u2014 /help \u0E14\u0E39\u0E04\u0E33\u0E2A\u0E31\u0E48\u0E07 \u00B7 /tools \u0E14\u0E39 tools \u00B7 @\u0E44\u0E1F\u0E25\u0E4C \u0E41\u0E19\u0E1A context/\u0E23\u0E39\u0E1B" });
     const before = value.slice(0, cursor);

package/dist/ui/render.js

@@ -48,6 +48,7 @@ export function Root({ needsSetup, appProps }) {
         const onComplete = (a) => {
             void (async () => {
                 const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('../brain.js');
+                const { linkBrainToProject } = await import('../brain-link.js');
                 const today = new Date().toISOString().slice(0, 10);
                 const target = expandHome(a.path);
                 try {
@@ -60,8 +61,12 @@ export function Root({ needsSetup, appProps }) {
                     });
                     await saveBrainPath(target);
                     const wired = await wireBrainMcp(target).catch(() => 'skip');
+                    const linked = await linkBrainToProject({ brainPath: target, cwd: process.cwd(), today }).catch(() => null);
+                    const linkNote = linked?.projectRelDir
+                        ? ` · project ${linked.projectRelDir} · ${linked.memoryCreated ? 'created' : 'linked'} ${BRAND.memoryFileName}`
+                        : '';
                     setBrainNote(`✅ second-brain — ${target} · สร้าง ${res.created.length} ไฟล์ · ` +
-                        `${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP เดิมอยู่แล้ว (ไม่ทับ)'} · เปิดใน Obsidian: Open folder as vault`);
+                        `${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว' : 'MCP เดิมอยู่แล้ว (ไม่ทับ)'}${linkNote} · เปิดใน Obsidian: Open folder as vault`);
                 }
                 catch (e) {
                     setBrainNote(`⚠ สร้าง second-brain ไม่สำเร็จ: ${e.message} — ลองใหม่ด้วย ${'`'}sanook brain init${'`'}`);
@@ -92,6 +97,7 @@ export function startBrainSetup() {
         const onComplete = (a) => {
             void (async () => {
                 const { scaffoldBrain, BRAIN_DEFAULTS, expandHome, wireBrainMcp } = await import('../brain.js');
+                const { linkBrainToProject } = await import('../brain-link.js');
                 const today = new Date().toISOString().slice(0, 10);
                 const target = expandHome(a.path);
                 const res = await scaffoldBrain(target, {
@@ -103,9 +109,12 @@ export function startBrainSetup() {
                 });
                 await saveBrainPath(target);
                 const wired = await wireBrainMcp(target).catch(() => 'skip');
+                const linked = await linkBrainToProject({ brainPath: target, cwd: process.cwd(), today }).catch(() => null);
                 unmount();
+                const linkLine = linked?.projectRelDir ? `\n   linked repo → ${linked.projectRelDir} · ${BRAND.memoryFileName} in cwd` : '';
                 process.stdout.write(`\n✅ second-brain — ${target}\n   สร้าง ${res.created.length} · ข้าม ${res.skipped.length} (มีอยู่แล้ว ไม่ทับ)` +
                     `\n   ${wired === 'added' ? 'wire filesystem MCP เข้า vault แล้ว (agent อ่าน/เขียนได้)' : 'MCP: มี server เดิมอยู่แล้ว (ไม่ทับ)'}` +
+                    `${linkLine}` +
                     `\n   เปิดใน Obsidian: Open folder as vault\n`);
                 resolve();
             })();

package/dist/usage-cli.js

@@ -0,0 +1,160 @@
+import { BRAND } from './brand.js';
+import { takeValue } from './cli-option-values.js';
+import { aggregateUsageEvents, loadUsageEvents, usageEventsPath } from './usage-ledger.js';
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function shiftDays(days) {
+    const d = new Date();
+    d.setDate(d.getDate() - days);
+    return d.toISOString().slice(0, 10);
+}
+export function parseUsageArgs(args) {
+    if (args.includes('-h') || args.includes('--help'))
+        return null;
+    let mode = 'daily';
+    let since;
+    let until;
+    let days = 30;
+    let json = false;
+    let noColor = false;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--json')
+            json = true;
+        else if (arg === '--no-color')
+            noColor = true;
+        else if (arg === '--since') {
+            const picked = takeValue(args, i);
+            if (!picked.value || !DATE_RE.test(picked.value))
+                return null;
+            since = picked.value;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--since=')) {
+            since = arg.slice('--since='.length);
+            if (!DATE_RE.test(since))
+                return null;
+        }
+        else if (arg === '--until') {
+            const picked = takeValue(args, i);
+            if (!picked.value || !DATE_RE.test(picked.value))
+                return null;
+            until = picked.value;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--until=')) {
+            until = arg.slice('--until='.length);
+            if (!DATE_RE.test(until))
+                return null;
+        }
+        else if (arg === '--days') {
+            const picked = takeValue(args, i);
+            const n = Number(picked.value);
+            if (!Number.isInteger(n) || n <= 0)
+                return null;
+            days = n;
+            i = picked.nextIndex;
+        }
+        else if (arg.startsWith('--days=')) {
+            const n = Number(arg.slice('--days='.length));
+            if (!Number.isInteger(n) || n <= 0)
+                return null;
+            days = n;
+        }
+        else if (!arg.startsWith('-'))
+            positional.push(arg);
+        else
+            return null;
+    }
+    if (positional[0]) {
+        if (!['daily', 'weekly', 'monthly', 'session'].includes(positional[0]))
+            return null;
+        mode = positional[0];
+    }
+    if (!since)
+        since = shiftDays(days - 1);
+    if (!until)
+        until = new Date().toISOString().slice(0, 10);
+    return { mode, since, until, days, json, noColor };
+}
+function fmt(n) {
+    return n.toLocaleString('en-US');
+}
+function fmtCost(n) {
+    return n > 0 ? `$${n.toFixed(2)}` : '$0.00';
+}
+function renderTable(title, rows, wide) {
+    if (!rows.length) {
+        return [
+            `╭${'─'.repeat(Math.max(42, title.length + 4))}╮`,
+            `│ ${title.padEnd(Math.max(40, title.length + 2))} │`,
+            `╰${'─'.repeat(Math.max(42, title.length + 4))}╯`,
+            '',
+            `(no usage recorded — run ${BRAND.cliName} and complete a turn first)`,
+            `ledger: ${usageEventsPath()}`,
+        ].join('\n');
+    }
+    const lines = [];
+    lines.push(`╭${'─'.repeat(title.length + 4)}╮`);
+    lines.push(`│ ${title} │`);
+    lines.push(`╰${'─'.repeat(title.length + 4)}╯`);
+    lines.push('');
+    if (wide) {
+        lines.push('┌────────────┬─────────┬──────────────────┬─────────┬─────────┬────────────┬────────────┐');
+        lines.push('│ Period     │ Turns   │ Models           │ Input   │ Output  │ Cache R/W  │ Cost (USD) │');
+        lines.push('├────────────┼─────────┼──────────────────┼─────────┼─────────┼────────────┼────────────┤');
+        for (const row of rows) {
+            const models = row.models.join(' ').slice(0, 16).padEnd(16);
+            const cache = `${fmt(row.cacheReadTokens)}/${fmt(row.cacheWriteTokens)}`.padStart(10);
+            lines.push(`│ ${row.label.padEnd(10)} │ ${String(row.turns).padStart(7)} │ ${models} │ ${fmt(row.inputTokens).padStart(7)} │ ${fmt(row.outputTokens).padStart(7)} │ ${cache} │ ${fmtCost(row.costUsd).padStart(10)} │`);
+        }
+        lines.push('└────────────┴─────────┴──────────────────┴─────────┴─────────┴────────────┴────────────┘');
+    }
+    else {
+        lines.push('┌────────────┬──────────────────┬─────────┬─────────┬────────────┐');
+        lines.push('│ Period     │ Models           │ Input   │ Output  │ Cost (USD) │');
+        lines.push('├────────────┼──────────────────┼─────────┼─────────┼────────────┤');
+        for (const row of rows) {
+            const models = row.models.join(' ').slice(0, 16).padEnd(16);
+            lines.push(`│ ${row.label.padEnd(10)} │ ${models} │ ${fmt(row.inputTokens).padStart(7)} │ ${fmt(row.outputTokens).padStart(7)} │ ${fmtCost(row.costUsd).padStart(10)} │`);
+        }
+        lines.push('└────────────┴──────────────────┴─────────┴─────────┴────────────┘');
+    }
+    const totalCost = rows.reduce((sum, row) => sum + row.costUsd, 0);
+    const totalTokens = rows.reduce((sum, row) => sum + row.totalTokens, 0);
+    lines.push('');
+    lines.push(`totals: ${fmt(totalTokens)} tokens · ${fmtCost(totalCost)} estimated · ledger: ${usageEventsPath()}`);
+    return lines.join('\n');
+}
+export async function renderUsageReport(options) {
+    const events = await loadUsageEvents({ since: options.since, until: options.until });
+    const rows = aggregateUsageEvents(events, options.mode);
+    if (options.json) {
+        return JSON.stringify({
+            agent: BRAND.cliName,
+            mode: options.mode,
+            since: options.since,
+            until: options.until,
+            events: events.length,
+            rows,
+            ledger: usageEventsPath(),
+        }, null, 2);
+    }
+    const title = options.mode === 'daily'
+        ? `${BRAND.productName} Usage Report — Daily`
+        : options.mode === 'weekly'
+            ? `${BRAND.productName} Usage Report — Weekly`
+            : options.mode === 'monthly'
+                ? `${BRAND.productName} Usage Report — Monthly`
+                : `${BRAND.productName} Usage Report — Sessions`;
+    const wide = (process.stdout.columns ?? 100) >= 100;
+    return renderTable(title, rows, wide);
+}
+export function usageHelpText() {
+    return [
+        `ใช้: ${BRAND.cliName} usage [daily|weekly|monthly|session] [--days N] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--json]`,
+        '',
+        'บันทึก token/cost ทุก agent turn ลง ~/.sanook/usage/events.jsonl (ccusage-style local ledger).',
+        'ปิดได้ด้วย SANOOK_DISABLE_USAGE=1',
+    ].join('\n');
+}

package/dist/usage-ledger.js

@@ -0,0 +1,169 @@
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { appHomePath, BRAND, usageLedgerEnabled } from './brand.js';
+const USAGE_DIR_NAME = 'usage';
+export function usageDirPath() {
+    return appHomePath(USAGE_DIR_NAME);
+}
+export function usageEventsPath() {
+    return join(usageDirPath(), 'events.jsonl');
+}
+function localDate(iso) {
+    const d = new Date(iso);
+    if (!Number.isFinite(d.getTime()))
+        return iso.slice(0, 10);
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+function num(value) {
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+/** Parse Codex JSONL turn.completed usage payloads into AI SDK Usage shape. */
+export function usageFromCodexPayload(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const u = raw;
+    const input = num(u.input_tokens ?? u.inputTokens ?? u.prompt_tokens ?? u.promptTokens);
+    const output = num(u.output_tokens ?? u.outputTokens ?? u.completion_tokens ?? u.completionTokens);
+    const cacheRead = num(u.cache_read_input_tokens ?? u.cached_input_tokens ?? u.cacheReadInputTokens ?? u.cachedInputTokens);
+    if (!input && !output && !cacheRead)
+        return null;
+    return { inputTokens: input, outputTokens: output, cachedInputTokens: cacheRead };
+}
+export async function appendUsageEvent(event) {
+    if (!usageLedgerEnabled())
+        return;
+    await mkdir(usageDirPath(), { recursive: true });
+    await appendFile(usageEventsPath(), `${JSON.stringify(event)}\n`, { mode: 0o600 });
+}
+export function recordAgentUsage(options) {
+    if (!usageLedgerEnabled())
+        return;
+    const snap = options.cost.snapshot();
+    const ts = new Date().toISOString();
+    const event = {
+        id: randomUUID(),
+        ts,
+        date: localDate(ts),
+        sessionId: options.sessionId,
+        source: options.source ?? 'headless',
+        model: options.model,
+        cwd: options.cwd,
+        inputTokens: snap.inputTokens,
+        outputTokens: snap.outputTokens,
+        cacheReadTokens: snap.cacheReadTokens,
+        cacheWriteTokens: snap.cacheWriteTokens,
+        totalTokens: snap.totalTokens,
+        costUsd: snap.hasPricing ? snap.costUsd : null,
+        priced: snap.hasPricing,
+    };
+    void appendUsageEvent(event).catch(() => { });
+}
+export async function loadUsageEvents(options = {}) {
+    let raw = '';
+    try {
+        raw = await readFile(usageEventsPath(), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const since = options.since;
+    const until = options.until;
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            const parsed = JSON.parse(t);
+            if (!parsed?.ts || typeof parsed.model !== 'string')
+                continue;
+            const date = parsed.date || localDate(parsed.ts);
+            if (since && date < since)
+                continue;
+            if (until && date > until)
+                continue;
+            out.push({ ...parsed, date });
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+    return out;
+}
+function mergeModels(map, model) {
+    const label = model.includes(':') ? model.split(':').slice(1).join(':') : model;
+    map.set(label, (map.get(label) ?? 0) + 1);
+}
+function topModels(map) {
+    return [...map.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 3)
+        .map(([model]) => `• ${model}`);
+}
+function weekKey(date) {
+    const d = new Date(`${date}T12:00:00`);
+    const day = d.getDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    d.setDate(d.getDate() + diff);
+    return localDate(d.toISOString());
+}
+function monthKey(date) {
+    return date.slice(0, 7);
+}
+export function aggregateUsageEvents(events, mode) {
+    const groups = new Map();
+    for (const event of events) {
+        const key = mode === 'daily'
+            ? event.date
+            : mode === 'weekly'
+                ? weekKey(event.date)
+                : mode === 'monthly'
+                    ? monthKey(event.date)
+                    : event.sessionId ?? `turn:${event.id}`;
+        const bucket = groups.get(key) ?? { models: new Map(), events: [] };
+        mergeModels(bucket.models, event.model);
+        bucket.events.push(event);
+        groups.set(key, bucket);
+    }
+    return [...groups.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([key, bucket]) => {
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let cacheReadTokens = 0;
+        let cacheWriteTokens = 0;
+        let costUsd = 0;
+        for (const event of bucket.events) {
+            inputTokens += event.inputTokens;
+            outputTokens += event.outputTokens;
+            cacheReadTokens += event.cacheReadTokens;
+            cacheWriteTokens += event.cacheWriteTokens;
+            costUsd += event.costUsd ?? 0;
+        }
+        const label = mode === 'session'
+            ? key.startsWith('turn:')
+                ? `${key.slice(5, 18)}…`
+                : key.slice(0, 24)
+            : key;
+        return {
+            key,
+            label,
+            models: topModels(bucket.models),
+            turns: bucket.events.length,
+            inputTokens,
+            outputTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+            totalTokens: inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens,
+            costUsd,
+        };
+    });
+}
+export function formatUsageLedgerHint() {
+    return `ดูประวัติ token ทั้งหมด: ${BRAND.cliName} usage daily`;
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "sanook-cli",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "A terminal AI coding agent — BYOK, 9 providers, MCP, cron gateway, skills, and git awareness. Built from scratch in TypeScript.",
   "type": "module",
   "bin": {
-    "sanook": "dist/bin.js"
+    "sanook": "dist/bin.js",
+    "sanookai": "dist/bin.js"
   },
   "files": [
     "dist",

package/scripts/postinstall.mjs

@@ -20,11 +20,11 @@ try {
   const bold = (s) => paint('1', s);
 
   if (isGlobal) {
-    console.log(`\n${bold('✅ sanook-cli พร้อมใช้')} — พิมพ์ ${cyan('sanook')} เพื่อเริ่ม`);
-    console.log(dim('   ยังพิมพ์ "sanook" ไม่เจอ? ปิด-เปิด terminal ใหม่ · ตรวจ: ') + cyan('npx sanook doctor') + '\n');
+    console.log(`\n${bold('✅ sanook-cli พร้อมใช้')} — พิมพ์ ${cyan('sanook')} หรือ ${cyan('sanookai')} เพื่อเริ่ม`);
+    console.log(dim('   Command installed: sanook (alias: sanookai) · ปิด-เปิด terminal ถ้ายังไม่เจอ · ') + cyan('sanook doctor') + '\n');
   } else {
-    console.log(`\n${bold('sanook-cli ลงแบบ local แล้ว')} — คำสั่ง ${cyan('sanook')} ยัง${bold('ไม่')}อยู่ใน PATH`);
-    console.log(`  ${dim('• รันเลยตอนนี้:')}            ${cyan('npx sanook')}`);
+    console.log(`\n${bold('sanook-cli ลงแบบ local แล้ว')} — ${cyan('sanook')} / ${cyan('sanookai')} ยัง${bold('ไม่')}อยู่ใน PATH`);
+    console.log(`  ${dim('• รันเลยตอนนี้:')}            ${cyan('npx sanook')}  ${dim('(or')} ${cyan('npx sanookai')}${dim(')')}`);
     console.log(`  ${dim('• ลงให้พิมพ์ sanook ตรงๆ:')}  ${cyan('npm install -g sanook-cli')}`);
     console.log(`  ${dim('• ตรวจ/แก้ PATH:')}           ${cyan('npx sanook doctor')}\n`);
   }