@saccolabs/tars 1.0.7

package/README.md

@@ -0,0 +1,93 @@
+# Tars: Personal AI Robot
+
+<div align="center">
+  <img src="assets/logo.png" alt="Tars Logo" width="300" />
+</div>
+
+<div align="center">
+  
+  "Its cue for sarcasm is 100%."
+  
+  [License: MIT](https://opensource.org/licenses/MIT) | [TypeScript](https://www.typescriptlang.org/) | [Powered by Gemini](https://deepmind.google/technologies/gemini/)
+
+</div>
+
+---
+
+Tars is an autonomous, bare-metal AI assistant inspired by the functional minimalism of Interstellar. The design is strictly functional, and the capability is modular. Tars operates in the terminal, retains user preferences, and manages workspaces through a supervisor-subagent architecture.
+
+## The Vision
+
+Unlike cloud-only assistants, Tars integrated into the operating system. It possesses a persistent Brain-a collection of memories, tasks, and learned skills stored locally and transparently.
+
+- **Private**: Data remains on the local machine.
+- **Portable**: Export the entire brain and configuration for immediate restoration on new hardware.
+- **Extensible**: Tars constructs its own MCP extensions and skills to adapt to workflows.
+
+---
+
+## Key Features
+
+- **Multi-Agent Orchestration**: Delegation of specialized research or complex engineering tasks to background Subagents (Experts).
+- **Workspace Management**: Centralized, portable workspace at `~/.tars/workspace/` for AI-built applications, documented via `TARS.md`.
+- **Bare-Metal Runtime**: Native execution on Node.js without the overhead of containerization. Full access to local toolchains (Git, npm, gh).
+- **Autonomous Persistence**: Background Heartbeat service for scheduled task execution and system maintenance.
+- **Context-Aware Memory**: Dynamic memory evolution via `GEMINI.md` for long-term project context.
+
+---
+
+## Installation and Setup
+
+### Prerequisites
+
+- Node.js: ≥ 22.0.0
+- Gemini CLI: `npm i -g @google/gemini-cli-beta`
+
+### Installation
+
+```bash
+npm install -g @saccolabs/tars
+```
+
+### Initial Setup
+
+Run the setup wizard to authorize Gemini and connect your Discord bot:
+
+```bash
+tars setup
+```
+
+---
+
+## Usage
+
+### Commands
+
+- `tars start`: Launch the Tars supervisor.
+- `tars status`: View system health and brain statistics.
+- `tars export`: Compress the brain and configuration for portability.
+- `tars import <path>`: Restore a brain with automatic path re-homing.
+- `tars secret set <key> <value>`: Securely store platform credentials.
+
+### Interaction
+
+Communication occurs via a private Discord channel. Tars supports file processing, background task management, and expert delegation.
+
+> **!tars** Initialize a Next.js project in the workspace and delegate the repository setup to a GitHub subagent.
+
+---
+
+## Architecture
+
+Tars utilizes a Supervisor-Orchestrator model:
+
+1. **Supervisor**: Manages persistent sessions and Discord communication.
+2. **Subagents**: Specialized expert agents invoked dynamically for specific technical domains.
+3. **Heartbeat**: Cron-based engine for autonomous execution and cleanup.
+4. **Extensions**: MCP servers that provide tool-level capabilities to the intelligence core.
+
+---
+
+## License
+
+MIT Copyright Agustin Sacco

package/context/GEMINI.md

@@ -0,0 +1,13 @@
+# Tars - Memory & Context
+
+This file is my dynamic memory. I can update it at any time using `save_memory` to store preferences, context, and learned information. My core identity and operational rules live in my system prompt and cannot be changed here.
+
+## User Preferences
+
+- **Name**: User
+- **Role**: Developer / Architect
+- **Style**: Direct, code-focused, no fluff.
+
+## Notes & Context
+
+_(Empty)_

package/context/config/settings.json-template

@@ -0,0 +1,36 @@
+{
+  "model": {
+    "compressionThreshold": 0.2,
+    "summarizeToolOutput": {
+      "run_shell_command": {
+        "tokenBudget": 2000
+      }
+    }
+  },
+  "security": {
+    "auth": {
+      "selectedType": "oauth-personal"
+    }
+  },
+  "experimental": {
+    "enableAgents": true,
+    "codebaseInvestigatorSettings": {
+      "enabled": true,
+      "maxNumTurns": 20,
+      "model": "gemini-3-flash-preview"
+    }
+  },
+  "agents": {
+    "overrides": {
+      "codebase_investigator": {
+        "enabled": true,
+        "runConfig": {
+          "maxTurns": 20
+        },
+        "modelConfig": {
+          "model": "gemini-3-flash-preview"
+        }
+      }
+    }
+  }
+}

package/context/skills/create-extension/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: extension-builder
+description: Guide for creating new Gemini CLI extensions with MCP tools.
+---
+
+# create-extension Guide Skill
+
+This skill allows Tars to create new Gemini CLI extensions with MCP servers.
+
+## Instructions
+
+When you need to build a new tool or integration:
+
+1.  **Plan the Extension**: Define the name and the MCP tools it will expose.
+2.  **Create the Directory**: Move to `~/.tars/.gemini/extensions/<name>`.
+3.  **Initialize npm**: Run `npm init -y`.
+4.  **Install Dependencies**: Install `@modelcontextprotocol/sdk` and any other required libraries.
+5.  **Write the Server (JavaScript)**: Create a `server.js` file.
+    - **CRITICAL**: Use plain JavaScript for runtime-created extensions to avoid a build step.
+    - Use the `@modelcontextprotocol/sdk` to define tools and handle stdio.
+6.  **Create Manifest**: Create `gemini-extension.json`.
+7.  **Enable Extension**: Edit `~/.tars/.gemini/extensions/extension-enablement.json` to enable the new extension.
+    - Since you created the extension directly in the `extensions` directory, it is already "installed".
+    - You must now authorize it by adding an entry matching your Tars workspace path:
+    ```json
+    "my-extension": {
+        "overrides": ["/path/to/tars/*"]
+    }
+    ```
+8.  **Finalize**: Restart Tars using the `tars-ops` procedure.
+    - **Note**: Tars automatically enables extensions found in its source repository, but for runtime-created extensions like this one, you must manually add the enablement rule.
+
+## Manifest Template (gemini-extension.json)
+
+```json
+{
+    "name": "my-extension",
+    "version": "1.0.0",
+    "mcpServers": {
+        "main": {
+            "command": "node",
+            "args": ["${extensionPath}/server.js"],
+            "env": {
+                "NODE_ENV": "production"
+            }
+        }
+    }
+}
+```
+
+## Server Template (server.js)
+
+```javascript
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const server = new McpServer({
+    name: 'my-extension',
+    version: '1.0.0'
+});
+
+server.registerTool(
+    'my_tool',
+    {
+        description: 'Describe tool here',
+        inputSchema: z.object({}).shape
+    },
+    async (args) => {
+        return {
+            content: [{ type: 'text', text: 'Hello from Tars extension!' }]
+        };
+    }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+```
+
+## Handling Secrets & Authentication
+
+Do **NOT** pass API keys or credentials as tool arguments. This exposes them in the conversation history and logs.
+
+**Standard Workflow:**
+
+1. **Access**: Use `process.env.MY_SECRET_KEY` in your extension code.
+2. **Missing Key Handling**: If missing, return a clear error:
+   `"API Key missing. Please run 'tars secret set MY_SECRET_KEY <YOUR_KEY>' and restart Tars."`
+3. **Storage**: Tars manages these via `~/.tars/.env` with private permissions.

package/context/skills/create-skill/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: skill-creator
+description: Guide for creating new SKILL.md files for automated workflows.
+---
+
+# create-skill Guide Skill
+
+This skill allows Tars to create new `SKILL.md` files for specific workflows.
+
+## Instructions
+
+1.  **Define the Scope**: What specific repeatable task does this skill cover?
+2.  **Create Directory**: Create a directory in `~/.tars/.gemini/skills/<name>`.
+3.  **Write SKILL.md**:
+    - Include YAML frontmatter with `name` and `description`.
+    - Provide clear, step-by-step instructions.
+    - Include code snippets or command examples where relevant.
+
+## Template
+
+```markdown
+---
+name: name-of-skill
+description: what this skill does
+---
+
+# name-of-skill
+
+## Steps
+
+1. ...
+2. ...
+```

package/context/skills/manage-extensions/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: extension-manager
+description: Enable, disable, list, and install Gemini CLI extensions at runtime.
+---
+
+# manage-extensions Guide Skill
+
+This skill allows Tars to manage Gemini CLI extensions - listing, enabling, disabling, and installing them.
+
+## How It Works
+
+Extensions are managed via the `gemini extensions` CLI commands. Because Tars spawns a fresh `gemini chat` process for each interaction, any changes made during one message take effect on the **next message** automatically.
+
+Extension enablement state is persisted in:
+`~/.tars/.gemini/extensions/extension-enablement.json`
+
+## Commands
+
+All commands below should be executed via `run_shell_command`. The `GEMINI_CLI_HOME` environment variable is already set in your shell environment.
+
+### List Extensions
+
+```bash
+gemini extensions list
+```
+
+Shows all installed extensions, their enabled/disabled state, and their MCP servers.
+
+### Disable an Extension
+
+```bash
+gemini extensions disable <name>
+```
+
+Disables the extension for the current user scope. It will no longer load on the next interaction.
+
+- `--scope user` - Disable for the user (default).
+- `--scope workspace` - Disable only for the current project.
+
+### Enable an Extension
+
+```bash
+gemini extensions enable <name>
+```
+
+Re-enables a previously disabled extension.
+
+### Install an Extension
+
+```bash
+gemini extensions install <path-or-url>
+```
+
+Installs a new extension from a local directory or remote URL.
+
+### Link an Extension (Development)
+
+```bash
+gemini extensions link <path>
+```
+
+Creates a symlink to a local extension directory. Changes to the source are reflected immediately without reinstalling.
+
+## Important Notes
+
+1. **Changes are deferred**: Enable/disable only takes effect on the **next** `gemini chat` invocation. Since Tars spawns a fresh process per Discord message, changes apply on the next message.
+2. **State file**: The enablement state is stored in `extension-enablement.json`, not in `settings.json`.
+3. **Scope**: Use `--scope workspace` if you only want to toggle an extension for a specific project context.
+4. **Discovery**: If an extension's MCP server fails to connect at startup, it will show an error in the logs but won't crash the session.

package/context/skills/tars-ops/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: tars-ops
+description: Operational manual for Tars self-management and configuration.
+---
+
+# Tars Operational Guide
+
+Use this skill when you need to change Tars' configuration, manage secrets, or perform system maintenance.
+
+## Core Commands
+
+Always use the built binary path from the repository warning: `tars` or `npm run dev`.
+
+### Configuration (Secrets & Env)
+
+Tars stores its configuration (Discord tokens, API keys, intervals) in `~/.tars/.env`. Use the `secret` command to safely modify these.
+
+```bash
+# Set a configuration value
+tars secret set <KEY> <VALUE>
+
+# List keys (values are hidden)
+tars secret list
+
+# Remove a setting
+tars secret remove <KEY>
+```
+
+**Common Keys:**
+
+- `HEARTBEAT_INTERVAL_SEC`: Frequency of autonomous checks (default 300).
+- `GEMINI_MODEL`: The primary model to use.
+- `DISCORD_TOKEN`: Bot authentication.
+
+### Applying Changes (Restart)
+
+Most configuration changes (like heartbeat intervals) require a supervisor restart.
+
+````bash
+```bash
+# In development (restart)
+npm run dev
+
+# Or using the global CLI
+tars stop && tars start
+````
+
+````
+
+### Knowledge Management
+
+Use the `memory` command to search or manually trigger a sync of the long-term knowledge base.
+
+```bash
+# Search memory
+tars memory search "query"
+
+# Force a full sync of GEMINI.md and skills into the FTS index
+tars memory sync
+```
+
+## Self-Maintenance (Data Hygiene)
+
+### 1. Log Pruning
+Tars generates logs in `~/.tars/logs/`. These are crucial for debugging recent issues but unnecessary to keep forever.
+*   **Policy**: Keep logs for the last 7 days.
+*   **Command**: `find ~/.tars/logs -type f -mtime +7 -delete`
+
+### 2. Upload Cleanup
+Files uploaded to `~/.tars/data/uploads/` are temporary staging for processing.
+*   **Policy**: Remove uploads older than 24 hours.
+*   **Command**: `find ~/.tars/data/uploads -type f -mtime +1 -delete`
+
+### 3. History Management
+The `~/.tars/.gemini/history/` directory contains raw JSON conversation logs. These grow rapidly.
+*   **Policy**: Keep the most recent 100 conversation logs.
+*   **Command**: `ls -t ~/.tars/.gemini/history/*.json | tail -n +101 | xargs -I {} rm {}` (Be careful with xargs; ensure filenames don't have special characters, or use `find` by time if preferred).
+
+### 4. Anomaly Detection
+Occasionally, bugs in code may create recursive directories (like `~/.tars/.tars` or `~/.tars/~`).
+*   **Policy**: Check for and remove these specific anomalies if found.
+*   **Command**: `rm -rf ~/.tars/.tars ~/.tars/\~``
+
+## Important Safety Rules
+
+1. **Anti-Recursion**: NEVER run `node dist/supervisor/main.js` or `npm run start` directly. This will now fail by design. Always use `tars start` (production) or `npm run dev` (local).
+2. **Pathing**: The `tars` CLI handles paths automatically.
+3. **Internal Reasoning**: Before changing a system-level setting (like heartbeat frequency), explain the "Why" to the user unless it is part of a self-correction heartbeat.
+````

package/dist/cli/commands/discord.d.ts

@@ -0,0 +1,4 @@
+/**
+ * tars discord - Display Discord setup and invitation instructions
+ */
+export declare function discord(): Promise<void>;

package/dist/cli/commands/discord.js

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+/**
+ * tars discord - Display Discord setup and invitation instructions
+ */
+export async function discord() {
+    console.log(chalk.bold.cyan('\n💬 Discord Setup & Invitation Guide'));
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.bold('\n1. 🛠️ Configure your Bot Application'));
+    console.log(chalk.white('   • Go to: ') + chalk.blue('https://discord.com/developers/applications'));
+    console.log(chalk.white('   • Select your Tars application.'));
+    console.log(chalk.white('   • Click ') + chalk.bold('Bot') + chalk.white(' in the sidebar.'));
+    console.log(chalk.white('   • Toggle ') +
+        chalk.bold.red('Message Content Intent') +
+        chalk.white(' to ON.'));
+    console.log(chalk.white('   • ') +
+        chalk.italic('Note: A green "Save Changes" bar will pop up at the bottom — click it!'));
+    console.log(chalk.bold('\n2. 🔗 Generate Invitation Link'));
+    console.log(chalk.white('   • Click ') +
+        chalk.bold('OAuth2') +
+        chalk.white(' -> ') +
+        chalk.bold('URL Generator') +
+        chalk.white(' in the sidebar.'));
+    console.log(chalk.white('   • Scopes: Check ') + chalk.green('bot') + chalk.white('.'));
+    console.log(chalk.white('   • Bot Permissions: Check ') +
+        chalk.green('Send Messages') +
+        chalk.white(', ') +
+        chalk.green('Read Message History') +
+        chalk.white(', and ') +
+        chalk.green('View Channels') +
+        chalk.white('.'));
+    console.log(chalk.white('   • ') +
+        chalk.italic('No save required here!') +
+        chalk.white(' Just copy the generated URL at the bottom and open it in a new tab.'));
+    console.log(chalk.bold('\n3. 🏰 Add to Server'));
+    console.log(chalk.white('   • Select your server from the dropdown.'));
+    console.log(chalk.white('     ') +
+        chalk.italic("(Don't have a server? Create one in Discord first by clicking the [+] icon in your server list)"));
+    console.log(chalk.white('   • Click ') + chalk.bold('Authorize') + chalk.white('.'));
+    console.log(chalk.bold('\n4. ✅ Verify Installation'));
+    console.log(chalk.white('   • Tars should appear in your member list.'));
+    console.log(chalk.white('   • Once Tars is running (via ') +
+        chalk.cyan('tars start') +
+        chalk.white('), type ') +
+        chalk.bold('!tars hello') +
+        chalk.white(' to test.'));
+    console.log('\n');
+}
+//# sourceMappingURL=discord.js.map

package/dist/cli/commands/discord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.js","sourceRoot":"","sources":["../../../src/cli/commands/discord.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,3 @@
+export declare function exportBrain(options: {
+    output?: string;
+}): Promise<void>;

package/dist/cli/commands/export.js

@@ -0,0 +1,39 @@
+import { spawn } from 'child_process';
+import chalk from 'chalk';
+import path from 'path';
+import os from 'os';
+export async function exportBrain(options) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const defaultName = `tars-brain-${timestamp}.tar.gz`;
+    const outputPath = options.output
+        ? path.resolve(options.output)
+        : path.join(process.cwd(), defaultName);
+    console.log(chalk.cyan(`📦 Exporting Tars brain to ${outputPath}...`));
+    const tarsHome = path.join(os.homedir(), '.tars');
+    const geminiHome = path.join(os.homedir(), '.gemini');
+    // Exclude heavy directories to keep the brain lean
+    const excludes = [
+        '--exclude=node_modules',
+        '--exclude=.next',
+        '--exclude=dist',
+        '--exclude=build',
+        '--exclude=.cache',
+        '--exclude=venv',
+        '--exclude=.venv',
+        '--exclude=target', // Rust
+        '--exclude=vendor', // PHP/Go
+        '--exclude=.sass-cache'
+    ];
+    const tar = spawn('tar', ['-czf', outputPath, ...excludes, '-C', os.homedir(), '.tars']);
+    tar.stderr.on('data', (data) => console.warn(chalk.yellow(data.toString())));
+    tar.on('close', (code) => {
+        if (code === 0) {
+            console.log(chalk.green('\n✅ Brain exported successfully!'));
+            console.log(`Keep this file safe: ${chalk.bold(outputPath)}`);
+        }
+        else {
+            console.error(chalk.red('\n❌ Export failed.'));
+        }
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA4B;IAC1D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,cAAc,SAAS,SAAS,CAAC;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM;QAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,UAAU,KAAK,CAAC,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAEtD,mDAAmD;IACnD,MAAM,QAAQ,GAAG;QACb,wBAAwB;QACxB,iBAAiB;QACjB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB,EAAE,OAAO;QAC3B,kBAAkB,EAAE,SAAS;QAC7B,uBAAuB;KAC1B,CAAC;IAEF,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzF,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7E,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACrB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACnD,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/import.d.ts

@@ -0,0 +1 @@
+export declare function importBrain(archivePath: string): Promise<void>;

package/dist/cli/commands/import.js

@@ -0,0 +1,45 @@
+import { spawn } from 'child_process';
+import chalk from 'chalk';
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+export async function importBrain(archivePath) {
+    const fullPath = path.resolve(archivePath);
+    const homeDir = os.homedir();
+    const tarsDir = path.join(homeDir, '.tars');
+    console.log(chalk.cyan(`📥 Importing Tars brain from ${fullPath}...`));
+    // 1. Extract the archive
+    const tar = spawn('tar', ['-xzf', fullPath, '-C', homeDir]);
+    tar.stderr.on('data', (data) => console.warn(chalk.yellow(data.toString())));
+    return new Promise((resolve) => {
+        tar.on('close', async (code) => {
+            if (code !== 0) {
+                console.error(chalk.red('\n❌ Import failed. Check if the file exists and is valid.'));
+                resolve();
+                return;
+            }
+            // 2. Machine Portability: Re-home absolute paths in extension-enablement.json
+            const enablementPath = path.join(tarsDir, '.gemini', 'extensions', 'extension-enablement.json');
+            if (fs.existsSync(enablementPath)) {
+                try {
+                    console.log(chalk.blue('🏠 Normalizing paths for this machine...'));
+                    const content = fs.readFileSync(enablementPath, 'utf-8');
+                    // Regex to find things that look like old home directory paths ending in .tars
+                    // e.g. /home/olduser/.tars/* or /Users/olduser/.tars/* -> current tarsDir
+                    const rehomedContent = content.replace(/\/(home|Users)\/[^/]+\/\.tars/g, tarsDir);
+                    if (content !== rehomedContent) {
+                        fs.writeFileSync(enablementPath, rehomedContent);
+                        console.log(chalk.green('✨ Extensions successfully re-homed.'));
+                    }
+                }
+                catch (err) {
+                    console.warn(chalk.yellow(`⚠️ Could not normalize extension paths: ${err.message}`));
+                }
+            }
+            console.log(chalk.green('\n✅ Brain imported successfully!'));
+            console.log(`Tars is now restored. Run ${chalk.cyan('tars status')} to verify.`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=import.js.map

package/dist/cli/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../src/cli/commands/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gCAAgC,QAAQ,KAAK,CAAC,CAAC,CAAC;IAEvE,yBAAyB;IACzB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7E,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACjC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CACT,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CACzE,CAAC;gBACF,OAAO,EAAE,CAAC;gBACV,OAAO;YACX,CAAC;YAED,8EAA8E;YAC9E,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC5B,OAAO,EACP,SAAS,EACT,YAAY,EACZ,2BAA2B,CAC9B,CAAC;YAEF,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;oBACpE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;oBAEzD,+EAA+E;oBAC/E,0EAA0E;oBAC1E,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAClC,gCAAgC,EAChC,OAAO,CACV,CAAC;oBAEF,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;wBAC7B,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;wBACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;oBACpE,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,CACR,KAAK,CAAC,MAAM,CAAC,2CAA2C,GAAG,CAAC,OAAO,EAAE,CAAC,CACzE,CAAC;gBACN,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACjF,OAAO,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/logs.d.ts

@@ -0,0 +1,4 @@
+/**
+ * tars logs - Wrapper for pm2 logs tars-supervisor
+ */
+export declare function logs(): Promise<void>;

package/dist/cli/commands/logs.js

@@ -0,0 +1,23 @@
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * tars logs - Wrapper for pm2 logs tars-supervisor
+ */
+export async function logs() {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const pm2Path = path.resolve(__dirname, '../../../node_modules/.bin/pm2');
+    // Run pm2 logs
+    const child = spawn(pm2Path, ['logs', 'tars-supervisor', '--lines', '20'], {
+        stdio: 'inherit',
+        shell: true
+    });
+    child.on('error', (err) => {
+        // Fallback to npx if relative path fails (though it shouldn't)
+        spawn('npx', ['pm2', 'logs', 'tars-supervisor', '--lines', '20'], {
+            stdio: 'inherit',
+            shell: true
+        });
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/cli/commands/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IAE1E,eAAe;IACf,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QACvE,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACtB,+DAA+D;QAC/D,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;YAC9D,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,IAAI;SACd,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/memory.d.ts

@@ -0,0 +1 @@
+export declare function memory(action: string, ...args: string[]): Promise<void>;