@ekkos/cli 1.3.6 → 1.3.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ekkOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/commands/dashboard.js

@@ -71,7 +71,9 @@ const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12
 // ── Pricing ──
 // Pricing per MTok from https://platform.claude.com/docs/en/about-claude/pricing
 const MODEL_PRICING = {
+    'claude-opus-4-6-20260514': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
     'claude-opus-4-6': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
+    'claude-sonnet-4-6-20260514': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-opus-4-5-20250620': { input: 5, output: 25, cacheWrite: 6.25, cacheRead: 0.50 },
     'claude-sonnet-4-6': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
     'claude-sonnet-4-5-20250929': { input: 3, output: 15, cacheWrite: 3.75, cacheRead: 0.30 },
@@ -96,12 +98,23 @@ function calculateTurnCost(model, usage) {
         (usage.cache_creation_tokens / 1000000) * p.cacheWrite +
         (usage.cache_read_tokens / 1000000) * p.cacheRead);
 }
-function getModelCtxSize(model) {
-    if (model.includes('opus'))
+function getModelCtxSize(model, contextTierHint) {
+    const normalized = (model || '').toLowerCase();
+    if (contextTierHint === '1m')
+        return 1000000;
+    // Claude 4.6 has GA 1M context in Claude Code/API.
+    if (/^claude-(?:opus|sonnet)-4-6(?:$|-)/.test(normalized))
+        return 1000000;
+    // Keep Gemini on the 1M class in dashboard context math.
+    if (normalized.startsWith('gemini-'))
+        return 1000000;
+    if (normalized.includes('1m'))
+        return 1000000;
+    if (normalized.includes('opus'))
         return 200000;
-    if (model.includes('haiku'))
+    if (normalized.includes('haiku'))
         return 200000;
-    if (model.includes('sonnet'))
+    if (normalized.includes('sonnet'))
         return 200000;
     return 200000; // Default Anthropic context
 }
@@ -183,12 +196,15 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const evictionState = typeof entry.message._ekkos_eviction_state === 'string'
                     ? entry.message._ekkos_eviction_state
                     : (parseCacheHintValue(cacheHint, 'eviction') || 'unknown');
+                const contextTierHint = typeof entry.message._ekkos_context_tier === 'string'
+                    ? entry.message._ekkos_context_tier.trim().toLowerCase()
+                    : undefined;
                 const inputTokens = usage.input_tokens || 0;
                 const outputTokens = usage.output_tokens || 0;
                 const cacheReadTokens = usage.cache_read_input_tokens || 0;
                 const cacheCreationTokens = usage.cache_creation_input_tokens || 0;
                 const contextTokens = inputTokens + cacheReadTokens + cacheCreationTokens;
-                const modelCtxSize = getModelCtxSize(model);
+                const modelCtxSize = getModelCtxSize(routedModel, contextTierHint);
                 const contextPct = (contextTokens / modelCtxSize) * 100;
                 const ts = entry.timestamp || new Date().toISOString();
                 if (!startedAt)
@@ -215,6 +231,7 @@ function parseJsonlFile(jsonlPath, sessionName) {
                 const turnData = {
                     turn: turnNum,
                     contextPct,
+                    modelContextSize: modelCtxSize,
                     input: inputTokens,
                     cacheRead: cacheReadTokens,
                     cacheCreate: cacheCreationTokens,
@@ -267,7 +284,9 @@ function parseJsonlFile(jsonlPath, sessionName) {
     const currentContextTokens = lastTurn
         ? lastTurn.input + lastTurn.cacheRead + lastTurn.cacheCreate
         : 0;
-    const modelContextSize = getModelCtxSize(model);
+    const modelContextSize = lastTurn
+        ? lastTurn.modelContextSize
+        : getModelCtxSize(model);
     return {
         sessionName,
         model,
@@ -1100,8 +1119,8 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
         try {
             const ctxPct = Math.min(data.currentContextPct, 100);
             const ctxColor = ctxPct < 50 ? 'green' : ctxPct < 80 ? 'yellow' : 'red';
-            const tokensK = Math.round(data.currentContextTokens / 1000);
-            const maxK = Math.round(data.modelContextSize / 1000);
+            const tokensLabel = fmtK(data.currentContextTokens);
+            const maxLabel = fmtK(data.modelContextSize);
             // Visual progress bar (fills available width)
             const contextInnerWidth = Math.max(10, contextBox.width - 2);
             // Extend bar slightly closer to mascot while keeping a small visual gap.
@@ -1121,7 +1140,7 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
             const hitColor = data.cacheHitRate >= 80 ? 'green' : data.cacheHitRate >= 50 ? 'yellow' : 'red';
             const cappedMax = Math.min(data.maxContextPct, 100);
             contextBox.setContent(` ${bar}\n` +
-                ` {${ctxColor}-fg}${ctxPct.toFixed(0)}%{/${ctxColor}-fg} ${tokensK}K/${maxK}K` +
+                ` {${ctxColor}-fg}${ctxPct.toFixed(0)}%{/${ctxColor}-fg} ${tokensLabel}/${maxLabel}` +
                 `  {white-fg}Input{/white-fg} $${breakdown.input.toFixed(2)}` +
                 `  {green-fg}Read{/green-fg} $${breakdown.read.toFixed(2)}` +
                 `  {yellow-fg}Write{/yellow-fg} $${breakdown.write.toFixed(2)}` +
@@ -1766,7 +1785,7 @@ async function launchDashboard(initialSessionName, initialJsonlPath, refreshMs,
                 const tier = cachedProfile.organization?.rate_limit_tier ?? 'unknown';
                 const status = cachedProfile.organization?.subscription_status ?? 'unknown';
                 const extraUsage = cachedProfile.organization?.has_extra_usage_enabled
-                    ? '  {green-fg}extra usage on{/green-fg}'
+                    ? '  {green-fg}extra usage on{/green-fg} {gray-fg}(legacy >200k only){/gray-fg}'
                     : '';
                 line2 =
                     ` {bold}Plan:{/bold} ${plan}  {bold}Tier:{/bold} ${tier}  {bold}Sub:{/bold} ${status}${extraUsage}`;

package/dist/commands/gemini.js

@@ -154,8 +154,19 @@ async function gemini(options = {}) {
         console.log(chalk_1.default.cyan('  🧠 ekkOS_Continuum Loaded!'));
     }
     console.log('');
+    // Extract any trailing arguments meant for the inner CLI
+    // We look for 'gemini' in process.argv and pass everything after it.
+    // If the user did `ekkos gemini -m gemini-3.1-pro-preview`, we want to pass `-m gemini-3.1-pro-preview`
+    let extraArgs = [];
+    const geminiIdx = process.argv.indexOf('gemini');
+    if (geminiIdx !== -1) {
+        extraArgs = process.argv.slice(geminiIdx + 1).filter(a => {
+            // Filter out ekkos wrapper options
+            return !['--skip-proxy', '-v', '--verbose'].includes(a) && !(a === '-s' || a === '--session' || process.argv[process.argv.indexOf(a) - 1] === '-s' || process.argv[process.argv.indexOf(a) - 1] === '--session');
+        });
+    }
     // Spawn Gemini CLI — stdio: inherit for full terminal passthrough
-    const child = (0, child_process_1.spawn)(geminiPath, [], {
+    const child = (0, child_process_1.spawn)(geminiPath, extraArgs, {
         stdio: 'inherit',
         env,
         cwd: process.cwd(),

package/dist/index.js

@@ -59,6 +59,7 @@ const scan_1 = require("./commands/scan");
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 // Get version from package.json (CommonJS compatible)
 const pkgPath = path.resolve(__dirname, '../package.json');
 const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
@@ -75,16 +76,12 @@ commander_1.program
     .addHelpText('after', [
     '',
     chalk_1.default.cyan.bold('Examples:'),
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos')}                              ${chalk_1.default.gray('Start Claude Code with ekkOS memory (default: run)')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos init')}                         ${chalk_1.default.gray('First-time setup — authenticate + configure your IDE')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan')}                         ${chalk_1.default.gray('Scan repo structure and seed system registry')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos scan --compile')}               ${chalk_1.default.gray('Scan, seed, and trigger compile pass')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run --dashboard')}              ${chalk_1.default.gray('Launch with live usage dashboard (tmux split)')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run -b')}                       ${chalk_1.default.gray('Launch with bypass permissions mode')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos doctor --fix')}                 ${chalk_1.default.gray('Check and auto-fix system prerequisites')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos usage daily')}                  ${chalk_1.default.gray("View today's token usage and costs")}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos gemini')}                       ${chalk_1.default.gray('Launch Gemini CLI with ekkOS memory proxy')}`,
-    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos swarm launch -t "build X"')}    ${chalk_1.default.gray('Launch parallel workers on a task')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos')}                              ${chalk_1.default.gray('Start Claude Code with ekkOS memory (default)')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos codex')}                        ${chalk_1.default.gray('Start Codex (OpenAI) mode')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos daemon start')}                 ${chalk_1.default.gray('Start the background mobile sync service')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos connect gemini')}               ${chalk_1.default.gray('Securely store your Gemini API key in the cloud')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos agent create --path ./repo')}   ${chalk_1.default.gray('Spawn a headless remote agent in a directory')}`,
+    `  ${chalk_1.default.gray('$')} ${chalk_1.default.white('ekkos run --dashboard')}              ${chalk_1.default.gray('Launch Claude with live usage dashboard')}`,
     '',
     chalk_1.default.gray('  Run ') + chalk_1.default.white('ekkos <command> --help') + chalk_1.default.gray(' for detailed options on any command.'),
     '',
@@ -152,38 +149,48 @@ commander_1.program
                 title: 'Getting Started',
                 icon: '▸',
                 commands: [
-                    { name: 'init', desc: 'Authenticate and configure your IDE (Claude, Cursor, Windsurf)' },
+                    { name: 'init', desc: 'First-time setup — authenticate and configure IDEs' },
                     { name: 'scan', desc: 'Scan repo structure and seed ekkOS system registry' },
-                    { name: 'status', desc: 'Show memory status and installation info' },
-                    { name: 'test', desc: 'Test connection to ekkOS memory API' },
-                    { name: 'doctor', desc: 'Check system prerequisites (Node, PTY, Claude, MCP)' },
+                    { name: 'status', desc: 'Show overall system status (Memory, Sync Daemon, Auth)' },
+                    { name: 'doctor', desc: 'Check system prerequisites and fix runaway processes' },
                 ],
             },
             {
-                title: 'Running',
+                title: 'Launch Agents (Local + Mobile Synced)',
                 icon: '▸',
                 commands: [
-                    { name: 'run', desc: 'Launch Claude Code with ekkOS memory', note: 'default' },
-                    { name: 'test-claude', desc: 'Launch Claude with proxy only (no PTY) for debugging' },
-                    { name: 'sessions', desc: 'List active Claude Code sessions' },
-                    { name: 'claw', desc: 'OpenClaw integration status and upgrade controls' },
+                    { name: 'run', desc: 'Launch Claude Code with memory and mobile control', note: 'default' },
+                    { name: 'codex', desc: 'Launch Codex (OpenAI) with mobile control' },
+                    { name: 'gemini', desc: 'Launch Gemini mode (ACP) with mobile control' },
+                    { name: 'acp', desc: 'Launch a generic ACP-compatible agent' },
                 ],
             },
             {
-                title: 'Monitoring & Usage',
+                title: 'Mobile Sync & Cloud (Synk)',
                 icon: '▸',
                 commands: [
-                    { name: 'usage', desc: 'Token usage and cost tracking (daily, weekly, monthly, session)' },
-                    { name: 'dashboard', desc: 'Live TUI dashboard for session monitoring' },
-                    { name: 'stream', desc: 'Stream capture status and management' },
-                    { name: 'hooks', desc: '[DEPRECATED] Hooks no longer needed — use `ekkos run`' },
+                    { name: 'daemon', desc: 'Manage background mobile sync service (start, stop, status)' },
+                    { name: 'connect', desc: 'Securely store AI vendor API keys in the cloud' },
+                    { name: 'sandbox', desc: 'Configure OS-level sandboxing for agent execution' },
+                    { name: 'notify', desc: 'Send push notifications to your Synk mobile app' },
                 ],
             },
             {
-                title: 'Swarm (Multi-Agent)',
+                title: 'Headless Agents (Remote Control)',
                 icon: '▸',
                 commands: [
-                    { name: 'swarm', desc: 'Parallel workers, Q-learning routing, swarm dashboard' },
+                    { name: 'agent', desc: 'Manage remote headless agents (create, list, stop)' },
+                    { name: 'swarm', desc: 'Parallel workers, Q-learning routing, and swarm dashboard' },
+                ],
+            },
+            {
+                title: 'Monitoring & Usage',
+                icon: '▸',
+                commands: [
+                    { name: 'auth', desc: 'Manage authentication for Memory, Agents, and Mobile App' },
+                    { name: 'usage', desc: 'Token usage and cost tracking (daily, weekly, monthly, session)' },
+                    { name: 'dashboard', desc: 'Live TUI dashboard for session monitoring' },
+                    { name: 'sessions', desc: 'List active local CLI sessions' },
                 ],
             },
         ];
@@ -501,6 +508,74 @@ swarmCmd
     (0, swarm_setup_1.swarmSetup)();
 });
 swarmCmd.addCommand(swarm_dashboard_1.swarmDashboardCommand);
+// --- Remote & Agent Wrapper Helpers ---
+function runRemoteCommand(command, ...args) {
+    const isAgent = command === 'agent';
+    const pkgName = isAgent ? 'ekkos-agent' : 'ekkos-remote';
+    const binName = isAgent ? 'ekkos-agent.mjs' : 'ekkos-synk.mjs';
+    // Try resolving local monorepo first
+    let binPath = path.resolve(__dirname, '../../' + pkgName + '/bin/' + binName);
+    // If we are installed globally (dist folder structure), resolve relatively
+    if (!fs.existsSync(binPath)) {
+        try {
+            const globalPath = require.resolve('@ekkos/' + (isAgent ? 'agent' : 'remote') + '/package.json');
+            binPath = path.join(path.dirname(globalPath), 'bin', binName);
+        }
+        catch (e) {
+            // Fallback relative to current dist
+            binPath = path.resolve(__dirname, '../../' + pkgName + '/bin/' + binName);
+        }
+    }
+    const p = (0, child_process_1.spawn)('node', [binPath, ...args], {
+        stdio: 'inherit',
+        env: process.env
+    });
+    p.on('exit', (code) => {
+        process.exit(code || 0);
+    });
+}
+// Mobile Sync & Cloud (Synk) Commands
+commander_1.program
+    .command('auth')
+    .description('Manage authentication for Memory, Agents, and Mobile App')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'auth', ...process.argv.slice(3)));
+commander_1.program
+    .command('codex')
+    .description('Launch Codex (OpenAI) with mobile control')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'codex', ...process.argv.slice(3)));
+commander_1.program
+    .command('acp')
+    .description('Launch a generic ACP-compatible agent')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'acp', ...process.argv.slice(3)));
+commander_1.program
+    .command('daemon')
+    .description('Manage background mobile sync service (start, stop, status)')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'daemon', ...process.argv.slice(3)));
+commander_1.program
+    .command('connect')
+    .description('Securely store AI vendor API keys in the cloud')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'connect', ...process.argv.slice(3)));
+commander_1.program
+    .command('sandbox')
+    .description('Configure OS-level sandboxing for agent execution')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'sandbox', ...process.argv.slice(3)));
+commander_1.program
+    .command('notify')
+    .description('Send push notifications to your Synk mobile app')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('synk', 'notify', ...process.argv.slice(3)));
+// Headless Agents (Remote Control)
+commander_1.program
+    .command('agent')
+    .description('Manage remote headless agents (create, list, stop)')
+    .allowUnknownOption()
+    .action(() => runRemoteCommand('agent', ...process.argv.slice(3)));
 // Handle `-help` (single dash) — rewrite to `--help` for Commander compatibility
 const helpIdx = process.argv.indexOf('-help');
 if (helpIdx !== -1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekkos/cli",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {
@@ -8,13 +8,6 @@
     "cli": "dist/index.js",
     "ekkos-capture": "dist/cache/capture.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "prepack": "node scripts/build-templates.js prepack",
-    "postpack": "node scripts/build-templates.js postpack",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "ekkos",
     "ai",
@@ -58,5 +51,9 @@
     "!dist/cron",
     "templates/CLAUDE.md",
     "templates/skills"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts"
+  }
+}