@ajvikram/relay 0.1.0

package/dist/cli/commands/diff.js

@@ -0,0 +1,61 @@
+import chalk from 'chalk';
+import { getRepoRoot } from '../../git/context.js';
+import { readHandoff, readHistory, readHistoryEntry, resolveCwd } from '../../storage/index.js';
+export async function diffCommand(options) {
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('✗ Not a git repository.'));
+        process.exit(1);
+    }
+    const currentHandoff = readHandoff(repoRoot);
+    const history = readHistory(repoRoot);
+    if (!currentHandoff && history.length === 0) {
+        console.error(chalk.red('✗ No handoff records found to compare.'));
+        process.exit(1);
+    }
+    let fromContent = null;
+    let toContent = null;
+    let fromLabel = '';
+    let toLabel = '';
+    if (options.from && options.to) {
+        fromContent = readHistoryEntry(repoRoot, options.from);
+        toContent = readHistoryEntry(repoRoot, options.to);
+        fromLabel = `History #${options.from}`;
+        toLabel = `History #${options.to}`;
+    }
+    else if (options.from) {
+        fromContent = readHistoryEntry(repoRoot, options.from);
+        toContent = currentHandoff ? JSON.stringify(currentHandoff, null, 2) : null;
+        fromLabel = `History #${options.from}`;
+        toLabel = 'Current Handoff';
+    }
+    else {
+        // Compare current with the latest history archive
+        if (history.length > 0) {
+            fromContent = readHistoryEntry(repoRoot, history[0].id);
+            fromLabel = `Previous Handoff (${history[0].id})`;
+        }
+        toContent = currentHandoff ? JSON.stringify(currentHandoff, null, 2) : null;
+        toLabel = 'Current Active Handoff';
+    }
+    if (!fromContent && !toContent) {
+        console.error(chalk.red('✗ Insufficient handoff history to produce a diff.'));
+        process.exit(1);
+    }
+    console.log(chalk.bold('\n🔄 Relay Handoff Comparison'));
+    console.log(chalk.dim(`Comparing: ${fromLabel || 'Start'} ➔ ${toLabel}`));
+    console.log(chalk.dim('─'.repeat(60)));
+    if (currentHandoff) {
+        console.log(chalk.bold('Active Goal:'), currentHandoff.session.goal);
+        console.log(chalk.bold('Active Status:'), currentHandoff.session.status);
+        console.log(chalk.bold('Decisions count:'), currentHandoff.decisions.length);
+        console.log(chalk.bold('Constraints count:'), currentHandoff.constraints.length);
+        console.log(chalk.bold('Failed approaches recorded:'), currentHandoff.failed_approaches.length);
+        console.log(chalk.bold('Pending next steps:'), currentHandoff.next_steps.length);
+    }
+    console.log(chalk.dim('─'.repeat(60)));
+    console.log(chalk.dim(`Tip: Run ${chalk.cyan('relay history')} to list all available handoff IDs.`));
+    console.log('');
+}
+//# sourceMappingURL=diff.js.map

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

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

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

@@ -0,0 +1,8 @@
+interface HistoryOptions {
+    dir?: string;
+    show?: string;
+    limit?: number;
+}
+export declare function historyCommand(options: HistoryOptions): Promise<void>;
+export {};
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/commands/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3E"}

package/dist/cli/commands/history.js

@@ -0,0 +1,32 @@
+import chalk from 'chalk';
+import { getRepoRoot } from '../../git/context.js';
+import { readHistory, readHistoryEntry, resolveCwd } from '../../storage/index.js';
+import { renderHistoryList } from '../../format/renderer.js';
+export async function historyCommand(options) {
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('✗ Not a git repository.'));
+        process.exit(1);
+    }
+    // ── Show a specific entry ──────────────────────────────────────────────────
+    if (options.show) {
+        const content = readHistoryEntry(repoRoot, options.show);
+        if (!content) {
+            console.error(chalk.red(`✗ No history entry found with ID: ${options.show}`));
+            console.error(chalk.dim(`  Run ${chalk.white('relay history')} to see available IDs.`));
+            process.exit(1);
+        }
+        console.log(content);
+        return;
+    }
+    // ── List history ───────────────────────────────────────────────────────────
+    const entries = readHistory(repoRoot);
+    const limited = options.limit ? entries.slice(0, options.limit) : entries;
+    console.log('');
+    console.log(renderHistoryList(limited));
+    if (entries.length > 0) {
+        console.log(chalk.dim(`To view a specific handoff: relay history --show <id>`));
+    }
+}
+//# sourceMappingURL=history.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQ7D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAuB;IAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,8EAA8E;IAC9E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE1E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+interface HookOptions {
+    dir?: string;
+}
+export declare function hookCommand(action: string, options: HookOptions): Promise<void>;
+export {};
+//# sourceMappingURL=hook.d.ts.map

package/dist/cli/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAQA,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAYD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8GrF"}

package/dist/cli/commands/hook.js

@@ -0,0 +1,118 @@
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, chmodSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { getRepoRoot, captureGitContext } from '../../git/context.js';
+import { resolveCwd, readHandoff, saveHandoff, initRelayDir, isRelayInitialized } from '../../storage/index.js';
+import { HandoffSchema } from '../../format/schema.js';
+import { randomUUID } from 'crypto';
+const HOOK_MARKER = '# Relay Git Auto-Draft Hook';
+const POST_COMMIT_SCRIPT = `#!/bin/sh
+${HOOK_MARKER}
+if command -v relay >/dev/null 2>&1; then
+  relay hook run post-commit >/dev/null 2>&1 &
+elif [ -f "./dist/cli/index.js" ]; then
+  node "./dist/cli/index.js" hook run post-commit >/dev/null 2>&1 &
+fi
+`;
+export async function hookCommand(action, options) {
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('✗ Not a git repository.'));
+        process.exit(1);
+    }
+    const hooksDir = join(repoRoot, '.git', 'hooks');
+    const postCommitPath = join(hooksDir, 'post-commit');
+    if (action === 'install') {
+        if (!isRelayInitialized(repoRoot)) {
+            initRelayDir(repoRoot);
+        }
+        if (existsSync(postCommitPath)) {
+            const existing = readFileSync(postCommitPath, 'utf-8');
+            if (existing.includes(HOOK_MARKER)) {
+                console.log(chalk.yellow('⚠️  Relay post-commit hook is already installed.'));
+                return;
+            }
+            writeFileSync(postCommitPath, existing.trimEnd() + '\n\n' + POST_COMMIT_SCRIPT);
+        }
+        else {
+            writeFileSync(postCommitPath, POST_COMMIT_SCRIPT);
+        }
+        try {
+            chmodSync(postCommitPath, '755');
+        }
+        catch {
+            // Best effort on Unix
+        }
+        console.log(chalk.green('✓ Installed Relay post-commit auto-draft hook'));
+        console.log(chalk.dim('  New commits will now automatically stage context into .relay/handoff.md\n'));
+        return;
+    }
+    if (action === 'uninstall') {
+        if (existsSync(postCommitPath)) {
+            const content = readFileSync(postCommitPath, 'utf-8');
+            if (content.includes(HOOK_MARKER)) {
+                if (content.trim() === POST_COMMIT_SCRIPT.trim()) {
+                    unlinkSync(postCommitPath);
+                }
+                else {
+                    const cleaned = content.replace(new RegExp(`${HOOK_MARKER}[\\s\\S]*?&`, 'g'), '').trim();
+                    writeFileSync(postCommitPath, cleaned ? cleaned + '\n' : '');
+                }
+                console.log(chalk.green('✓ Uninstalled Relay post-commit hook'));
+                return;
+            }
+        }
+        console.log(chalk.yellow('Relay hook was not installed.'));
+        return;
+    }
+    if (action === 'run') {
+        // Execute hook logic
+        const gitContext = await captureGitContext(repoRoot);
+        let handoff = readHandoff(repoRoot, gitContext.repository.branch);
+        if (handoff) {
+            // Enrich existing handoff with latest commit info
+            const headMsg = gitContext.repository.head_message;
+            const alreadyHasDecision = headMsg && handoff.decisions.some((d) => d.what.includes(headMsg));
+            if (headMsg && !alreadyHasDecision && headMsg !== 'initial commit') {
+                handoff.decisions.push({
+                    what: `Commit: ${headMsg}`,
+                    why: 'Auto-recorded from commit message',
+                    evidence: gitContext.repository.head_commit,
+                });
+            }
+            handoff.repository = gitContext.repository;
+            handoff.raw_diff = gitContext.raw_diff || handoff.raw_diff;
+            handoff.files_modified = gitContext.files_modified.length > 0 ? gitContext.files_modified : handoff.files_modified;
+            saveHandoff(repoRoot, handoff);
+        }
+        else {
+            // Create initial draft
+            const newDraft = HandoffSchema.parse({
+                version: '1',
+                id: randomUUID().slice(0, 8),
+                timestamp: new Date().toISOString(),
+                source_platform: 'other',
+                repository: gitContext.repository,
+                raw_diff: gitContext.raw_diff || undefined,
+                files_modified: gitContext.files_modified,
+                session: {
+                    goal: gitContext.repository.head_message || 'Work in progress',
+                    status: 'in_progress',
+                    token_exhausted: false,
+                },
+                decisions: gitContext.repository.head_message
+                    ? [{ what: `Commit: ${gitContext.repository.head_message}`, why: 'Initial commit in session', evidence: gitContext.repository.head_commit }]
+                    : [],
+                constraints: [],
+                failed_approaches: [],
+                next_steps: [],
+            });
+            saveHandoff(repoRoot, newDraft);
+        }
+        return;
+    }
+    console.log(chalk.yellow(`Unknown hook action: ${action}`));
+    console.log(chalk.dim('Available: relay hook install, relay hook uninstall'));
+}
+//# sourceMappingURL=hook.js.map

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

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

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

@@ -0,0 +1,4 @@
+export declare function initCommand(options: {
+    dir?: string;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C1E"}

package/dist/cli/commands/init.js

@@ -0,0 +1,41 @@
+import chalk from 'chalk';
+import { existsSync } from 'fs';
+import { getRepoRoot } from '../../git/context.js';
+import { initRelayDir, isRelayInitialized, resolveCwd, RELAY_DIR } from '../../storage/index.js';
+export async function initCommand(options) {
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('✗ Not a git repository. Relay works best inside a git repo.'));
+        console.error(chalk.dim('  Run `git init` first, or navigate to a git repository.'));
+        process.exit(1);
+    }
+    if (isRelayInitialized(repoRoot)) {
+        console.log(chalk.yellow(`⚠ Relay is already initialized in this repository.`));
+        console.log(chalk.dim(`  Directory: ${repoRoot}/${RELAY_DIR}/`));
+        console.log(``);
+        console.log(`Run ${chalk.cyan('relay save')} to create your first handoff.`);
+        return;
+    }
+    console.log(chalk.bold('Initializing Relay...'));
+    console.log(chalk.dim(`Repository: ${repoRoot}`));
+    console.log(``);
+    initRelayDir(repoRoot);
+    console.log(chalk.green('✓ Created .relay/ directory'));
+    console.log(chalk.green('✓ Created .relay/history/ directory'));
+    console.log(chalk.green('✓ Created .relay/config.yaml'));
+    const gitignorePath = `${repoRoot}/.gitignore`;
+    if (existsSync(gitignorePath)) {
+        console.log(chalk.green('✓ Updated .gitignore'));
+    }
+    console.log(``);
+    console.log(chalk.bold.green('✓ Relay initialized!'));
+    console.log(``);
+    console.log(`Next steps:`);
+    console.log(`  ${chalk.cyan('relay save')}     — save context when you hit a token limit`);
+    console.log(`  ${chalk.cyan('relay load')}     — load context when starting on a new platform`);
+    console.log(`  ${chalk.cyan('relay install')}  — add bootstrap rules to each AI platform`);
+    console.log(``);
+    console.log(chalk.dim(`Tip: Commit ${chalk.white('.relay/handoff.md')} so your team can also pick up context.`));
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,18 @@
+export type SupportedPlatform = 'claude' | 'cursor' | 'antigravity' | 'copilot' | 'all';
+export interface InstallOptions {
+    dir?: string;
+    dryRun?: boolean;
+    global?: boolean;
+}
+export interface InstallTarget {
+    name: string;
+    rule: string;
+    globalRule?: string;
+    getPath: (repoRoot: string) => string;
+    getGlobalPath?: () => string;
+    appendMode: 'append' | 'prepend' | 'create';
+    marker: string;
+}
+export declare const PLATFORMS: Record<Exclude<SupportedPlatform, 'all'>, InstallTarget>;
+export declare function installCommand(platform: SupportedPlatform, options: InstallOptions): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,CAAC;AAExF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA8FD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,EAAE,aAAa,CAqC9E,CAAC;AAEF,wBAAsB,cAAc,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/cli/commands/install.js

@@ -0,0 +1,203 @@
+import chalk from 'chalk';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { getRepoRoot } from '../../git/context.js';
+import { resolveCwd } from '../../storage/index.js';
+import { registerRepo } from '../../storage/global.js';
+// ─── Bootstrap rules ──────────────────────────────────────────────────────────
+// These are injected into platform-specific config files so agents
+// automatically read the handoff on session start.
+const RELAY_RULE_CLAUDE = `
+## Relay Context Handoff
+
+Before starting ANY task in this repository, check if \`.relay/handoff.md\` exists.
+If it does:
+1. Read it completely before doing anything else
+2. Acknowledge the handoff context: state the goal, current status, and what you will do first
+3. Respect all listed constraints — do not violate them without flagging it explicitly
+4. Do not repeat any of the listed failed approaches
+
+If \`.relay/handoff.md\` does not exist, proceed normally.
+
+When asked to "save a handoff" or "write a relay handoff", run: \`relay save\`
+Or if the relay CLI is not available, write a structured summary to \`.relay/handoff.md\` following the format in that file.
+`.trim();
+const RELAY_RULE_CURSOR = `
+# Relay Context Handoff
+
+When starting work in this repository:
+1. Check if \`.relay/handoff.md\` exists
+2. If it exists, read it FIRST before taking any action
+3. Acknowledge the handoff: state the goal and your first action
+4. Respect all constraints listed — flag any violations explicitly
+5. Never repeat approaches marked as failed
+
+To save context before switching platforms: run \`relay save\` in the terminal.
+`.trim();
+const RELAY_RULE_ANTIGRAVITY = `
+## Relay Context Handoff
+
+When working in this repository, always check for \`.relay/handoff.md\` before starting.
+If it exists, read it and orient yourself before taking any actions.
+Acknowledge the handoff context and state what you will do first.
+`.trim();
+const RELAY_RULE_COPILOT = `
+# Relay Context Handoff
+
+This repository uses [Relay](https://github.com/relay-ai/relay) for cross-platform AI context handoff.
+
+When starting a session:
+- Check if \`.relay/handoff.md\` exists
+- If yes, read it before making any suggestions or changes
+- Acknowledge the handoff context before proceeding
+- Respect all constraints listed in the file
+`.trim();
+// Global rule variant (applies to any workspace/repo)
+const RELAY_GLOBAL_RULE_CLAUDE = `
+## Relay Global Context Handoff
+
+Whenever working in a project workspace:
+1. Check if \`.relay/handoff.md\` exists in the current project or workspace root.
+2. If present, read it FIRST before taking any action.
+3. Acknowledge active context: state the current goal, constraints, and your initial step.
+4. When switching tasks or platforms, encourage running \`relay save\`.
+`.trim();
+const RELAY_GLOBAL_RULE_CURSOR = `
+# Relay Global Context Handoff
+
+Whenever working in any workspace:
+1. Check if \`.relay/handoff.md\` exists at the root.
+2. If it exists, read it FIRST before making changes.
+3. Respect all stated constraints and avoid listed failed approaches.
+4. Run \`relay save\` when completing or pausing a session.
+`.trim();
+const RELAY_GLOBAL_RULE_ANTIGRAVITY = `
+## Relay Global Context Handoff
+
+When working in any project, check if \`.relay/handoff.md\` exists in the workspace.
+If it exists, read it to restore context before taking actions.
+`.trim();
+const RELAY_GLOBAL_RULE_COPILOT = `
+# Relay Global Context Handoff
+
+When working in any project:
+- Check if \`.relay/handoff.md\` exists in the repository.
+- If present, read it before answering or suggesting code changes.
+- Respect constraints and pending tasks defined in the handoff.
+`.trim();
+export const PLATFORMS = {
+    claude: {
+        name: 'Claude / Claude Code',
+        rule: RELAY_RULE_CLAUDE,
+        globalRule: RELAY_GLOBAL_RULE_CLAUDE,
+        getPath: (root) => join(root, 'CLAUDE.md'),
+        getGlobalPath: () => join(homedir(), '.claude', 'CLAUDE.md'),
+        appendMode: 'append',
+        marker: 'Relay Context Handoff',
+    },
+    cursor: {
+        name: 'Cursor',
+        rule: RELAY_RULE_CURSOR,
+        globalRule: RELAY_GLOBAL_RULE_CURSOR,
+        getPath: (root) => join(root, '.cursor', 'rules', 'relay.mdc'),
+        getGlobalPath: () => join(homedir(), '.cursor', 'rules', 'relay.mdc'),
+        appendMode: 'create',
+        marker: 'Relay Context Handoff',
+    },
+    antigravity: {
+        name: 'Antigravity',
+        rule: RELAY_RULE_ANTIGRAVITY,
+        globalRule: RELAY_GLOBAL_RULE_ANTIGRAVITY,
+        getPath: (root) => join(root, 'AGENTS.md'),
+        getGlobalPath: () => join(homedir(), '.antigravity', 'AGENTS.md'),
+        appendMode: 'append',
+        marker: 'Relay Context Handoff',
+    },
+    copilot: {
+        name: 'GitHub Copilot',
+        rule: RELAY_RULE_COPILOT,
+        globalRule: RELAY_GLOBAL_RULE_COPILOT,
+        getPath: (root) => join(root, '.github', 'copilot-instructions.md'),
+        getGlobalPath: () => join(homedir(), '.config', 'github-copilot', 'instructions.md'),
+        appendMode: 'append',
+        marker: 'Relay Context Handoff',
+    },
+};
+export async function installCommand(platform, options) {
+    const isGlobal = Boolean(options.global);
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!isGlobal && !repoRoot) {
+        console.error(chalk.red('✗ Not a git repository. Use --global (-g) to install system-wide rules.'));
+        process.exit(1);
+    }
+    const targets = platform === 'all'
+        ? Object.entries(PLATFORMS)
+        : [[platform, PLATFORMS[platform]]];
+    if (options.dryRun) {
+        console.log(chalk.yellow(`DRY RUN — no files will be modified (${isGlobal ? 'Global' : 'Repository'} mode)`));
+        console.log('');
+    }
+    for (const [key, target] of targets) {
+        if (!target) {
+            console.error(chalk.red(`✗ Unknown platform: ${key}`));
+            continue;
+        }
+        const filePath = isGlobal
+            ? (target.getGlobalPath ? target.getGlobalPath() : target.getPath(homedir()))
+            : target.getPath(repoRoot);
+        const displayPath = isGlobal
+            ? filePath.replace(homedir(), '~')
+            : filePath.replace(repoRoot, '');
+        console.log(chalk.bold(`Installing ${isGlobal ? 'global ' : ''}Relay rule for ${target.name}...`));
+        console.log(chalk.dim(`  File: ${displayPath}`));
+        const ruleContent = isGlobal && target.globalRule ? target.globalRule : target.rule;
+        // Check if already installed
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, 'utf-8');
+            if (existing.includes(target.marker)) {
+                console.log(chalk.yellow(`  ⚠ Already installed — skipping`));
+                console.log('');
+                continue;
+            }
+        }
+        if (!options.dryRun) {
+            // Create parent directories if needed
+            const lastSlash = filePath.lastIndexOf('/');
+            if (lastSlash > 0) {
+                const dir = filePath.substring(0, lastSlash);
+                mkdirSync(dir, { recursive: true });
+            }
+            if (target.appendMode === 'create') {
+                writeFileSync(filePath, ruleContent + '\n');
+            }
+            else {
+                const existing = existsSync(filePath) ? readFileSync(filePath, 'utf-8') : '';
+                const separator = existing.length > 0 ? '\n\n---\n\n' : '';
+                if (target.appendMode === 'prepend') {
+                    writeFileSync(filePath, ruleContent + separator + existing);
+                }
+                else {
+                    writeFileSync(filePath, existing.trimEnd() + separator + ruleContent + '\n');
+                }
+            }
+        }
+        console.log(chalk.green(`  ✓ Installed`));
+        console.log('');
+    }
+    // If in a repo, register it globally as well
+    if (repoRoot && !options.dryRun) {
+        registerRepo(repoRoot);
+    }
+    console.log(chalk.bold.green(`✓ ${isGlobal ? 'Global bootstrap' : 'Bootstrap'} rules installed!`));
+    console.log('');
+    if (isGlobal) {
+        console.log(chalk.dim('All AI sessions across your computer will now check for .relay/handoff.md in workspace roots.'));
+    }
+    else {
+        console.log(chalk.dim('The next AI session in this repo will automatically read .relay/handoff.md'));
+    }
+    console.log(chalk.dim('Remember to run `relay save` before switching platforms.'));
+}
+//# sourceMappingURL=install.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAUvD,iFAAiF;AACjF,mEAAmE;AACnE,mDAAmD;AAEnD,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;CAczB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,iBAAiB,GAAG;;;;;;;;;;;CAWzB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,sBAAsB,GAAG;;;;;;CAM9B,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,kBAAkB,GAAG;;;;;;;;;;CAU1B,CAAC,IAAI,EAAE,CAAC;AAET,sDAAsD;AACtD,MAAM,wBAAwB,GAAG;;;;;;;;CAQhC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,wBAAwB,GAAG;;;;;;;;CAQhC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,6BAA6B,GAAG;;;;;CAKrC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,yBAAyB,GAAG;;;;;;;CAOjC,CAAC,IAAI,EAAE,CAAC;AAcT,MAAM,CAAC,MAAM,SAAS,GAA6D;IACjF,MAAM,EAAE;QACN,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,wBAAwB;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC;QAC5D,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,uBAAuB;KAChC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,wBAAwB;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC;QAC9D,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC;QACrE,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,uBAAuB;KAChC;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,6BAA6B;QACzC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC;QACjE,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,uBAAuB;KAChC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,yBAAyB;QACrC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,yBAAyB,CAAC;QACnE,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,CAAC;QACpF,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,uBAAuB;KAChC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA2B,EAC3B,OAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC,CAAC;QACpG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,KAAK,KAAK;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAyD;QACnF,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,QAA6C,CAAC,CAAuD,CAAC,CAAC;IAEjI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wCAAwC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,CAAC,CAAC;QAC9G,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAS,CAAC,CAAC;QAE9B,MAAM,WAAW,GAAG,QAAQ;YAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC;YAClC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAS,EAAE,EAAE,CAAC,CAAC;QAEpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QACnG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC,CAAC;QAEjD,MAAM,WAAW,GAAG,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAEpF,6BAA6B;QAC7B,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,sCAAsC;YACtC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC7C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBAE3D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACpC,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC;gBAC/E,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,IAAI,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW,mBAAmB,CAAC,CAAC,CAAC;IACnG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+FAA+F,CAAC,CAAC,CAAC;IAC1H,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,9 @@
+interface LoadOptions {
+    dir?: string;
+    prompt?: boolean;
+    clipboard?: boolean;
+    json?: boolean;
+}
+export declare function loadCommand(options: LoadOptions): Promise<void>;
+export {};
+//# sourceMappingURL=load.d.ts.map

package/dist/cli/commands/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/load.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuErE"}

package/dist/cli/commands/load.js

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import clipboard from 'clipboardy';
+import { getRepoRoot } from '../../git/context.js';
+import { readHandoff, resolveCwd } from '../../storage/index.js';
+import { renderMarkdown, renderAgentPrompt } from '../../format/renderer.js';
+export async function loadCommand(options) {
+    const cwd = resolveCwd(options.dir);
+    const repoRoot = await getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('✗ Not a git repository.'));
+        process.exit(1);
+    }
+    const handoff = readHandoff(repoRoot);
+    if (!handoff) {
+        console.error(chalk.red('✗ No handoff found.'));
+        console.error(chalk.dim(`  Expected: ${repoRoot}/.relay/handoff.json`));
+        console.error('');
+        console.error(`Run ${chalk.cyan('relay save')} first to create a handoff.`);
+        process.exit(1);
+    }
+    // ── Output modes ───────────────────────────────────────────────────────────
+    if (options.json) {
+        console.log(JSON.stringify(handoff, null, 2));
+        return;
+    }
+    let output;
+    if (options.prompt) {
+        // Compact agent prompt — optimised for pasting into a new session
+        output = renderAgentPrompt(handoff);
+    }
+    else {
+        // Full Markdown — same as the file
+        output = renderMarkdown(handoff);
+    }
+    // ── Copy to clipboard if requested ────────────────────────────────────────
+    if (options.clipboard) {
+        try {
+            await clipboard.write(output);
+            console.log(chalk.green('✓ Handoff copied to clipboard!'));
+            console.log(chalk.dim('Paste it at the start of your new AI agent session.'));
+            return;
+        }
+        catch {
+            console.error(chalk.yellow('⚠ Could not access clipboard. Printing to stdout instead.'));
+            console.log('');
+        }
+    }
+    // ── Print to stdout ────────────────────────────────────────────────────────
+    if (!options.prompt && !options.clipboard) {
+        // Show a header when printing the full markdown
+        const ts = new Date(handoff.timestamp).toLocaleString();
+        const statusIcon = handoff.session.status === 'completed' ? '✅' : handoff.session.status === 'blocked' ? '🔴' : '🟡';
+        console.log(chalk.bold(`\n${statusIcon} Relay Handoff`));
+        console.log(chalk.dim(`Source: ${handoff.source_platform} | Saved: ${ts} | Branch: ${handoff.repository.branch}`));
+        console.log('');
+        console.log(chalk.dim('─'.repeat(60)));
+        console.log('');
+    }
+    console.log(output);
+    if (!options.prompt) {
+        console.log('');
+        console.log(chalk.dim('─'.repeat(60)));
+        console.log('');
+        console.log(chalk.dim('Tips:'));
+        console.log(chalk.dim(`  relay load --prompt     — compact agent-ready prompt`));
+        console.log(chalk.dim(`  relay load --clipboard  — copy to clipboard`));
+    }
+}
+//# sourceMappingURL=load.js.map