cliper-memory 0.1.0 → 0.1.2

package/README.md

@@ -1,268 +1,212 @@
-# Cliper Memory
-
-> Turn any codebase into a structured knowledge graph for AI agents.
-
-Cliper Memory is a repository intelligence engine that converts source code, Git history, architecture, dependencies, and project metadata into structured memories that can be ingested by knowledge graph systems like Cognee.
-
-Instead of storing a single flattened context document, Cliper Memory models a repository as interconnected memory objects, enabling AI systems to understand software at a much higher semantic level.
+# Cliper Memory 
+> **New to Cliper?** Start with the [friendly tour](https://github.com/bristinWild/cliper-sdk/blob/main/About-Cliper.md).
 
 > Transform any repository into a persistent AI memory graph.
 
----
-
-## Why?
-
-Large language models struggle with large repositories because:
-
-- Repository context exceeds token limits
-- Important relationships are lost in flattened documents
-- Git history is ignored
-- Architecture is difficult to infer
-- Dependencies become disconnected
-
-Cliper Memory solves this by converting repositories into structured memories that preserve relationships between files, modules, commits, packages, architecture, and future project artifacts.
-
----
-
-## Features
-
-### Repository Intelligence
+**Git stores source code. Cliper stores engineering knowledge.**
 
-- Repository Memory
-- Git Memory
-- File Summary Memory
-- Dependency Memory
-- Architecture Memory
-- Responsibility Memory
-- External Package Memory
-- Gap Detection Memory
-- Commit Memory
+Every AI conversation about your codebase currently starts from zero - you re-send files, re-explain architecture, re-describe decisions. Cliper Memory inverts this: run `cliper init` once, and your repository becomes a structured knowledge graph in Cognee Cloud - typed memories connected by explicit relationships - that any AI application can query from that point on.
 
-### Coming Soon
-
-- Release Memory
-- GitHub Issue Memory
-- Pull Request Memory
-- GitHub Discussion Memory
-- Timeline Memory
-- Semantic Repository Search
-- Multi-provider Memory Support
+```text
+Repository
+    │
+    ▼
+cliper init            ← scan, extract, structure
+    │
+    ▼
+Structured Memories    ← 10+ typed memory objects
+    │
+    ▼
+Cognee Cloud           ← knowledge graph (cognify)
+    │
+    ├──────────────┐
+    ▼              ▼
+Mobile App     AI Agents
+    │              │
+    └──────┬───────┘
+           ▼
+Persistent Engineering Knowledge
+```
 
 ---
 
-## Memory Types
+## Requirements
 
-Every repository is transformed into structured memory objects.
+- **Node.js 18+** (native `fetch` is used throughout)
+- A **GitHub Personal Access Token** - `repo` (or `public_repo`) scope, used to fetch issues and pull requests
+- A **Cognee Cloud** account - base URL and API key from your dashboard
 
-Example:
+## Installation
 
-```
-Repository
-│
-├── Git
-│   ├── Commit
-│   └── Release
-│
-├── Architecture
-│   ├── Module
-│   ├── Dependency
-│   └── Responsibility
-│
-├── Files
-│
-├── Packages
-│
-├── Issues
-│
-├── Pull Requests
-│
-└── Discussions
+```bash
+npm install -g cliper-memory
 ```
 
-Each memory contains:
-
-- unique identifier
-- memory type
-- metadata
-- semantic relationships
-- searchable content
-
----
-
-## Example Memory
-
-```json
-{
-  "id": "dependency:src/index.ts->src/commands/init",
-  "type": "dependency",
-  "title": "src/index.ts imports src/commands/init",
-  "relationships": [
-    "src/index.ts",
-    "src/commands/init"
-  ]
-}
-```
+This installs the `cliper` binary.
 
 ---
 
-## Supported Memory Providers
+## Setup Guide
 
-Current:
+### 1. Authenticate
 
-- Cognee
+```bash
+cliper auth
+```
 
-Planned:
+This runs two configuration steps:
 
-- Neo4j
-- Memgraph
-- Graphiti
-- LanceDB
-- Local JSON Memory
+**GitHub** - paste your Personal Access Token. Cliper verifies it against the GitHub API and registers your user. The token is used to enrich repository memory with issues and pull requests.
 
----
+**Cognee** - paste your Cognee Base URL (e.g. `https://tenant-xxxx.aws.cognee.ai`) and API Key. This is where your memory graphs are stored.
 
-## Installation
+Credentials are written to `~/.cliper/config.json` with `0600` permissions. You can also configure a single provider:
 
 ```bash
-git clone https://github.com/<your-username>/cliper-memory.git
-
-cd cliper-memory
-
-npm install
+cliper auth github
+cliper auth cognee
 ```
 
----
-
-## Configuration
+### 2. Initialize a repository
 
-Create a `.env` file.
+```bash
+cd your-project
+cliper init
+```
 
-```env
-COGNEE_BASE_URL=http://localhost:8000
-COGNEE_API_KEY=YOUR_API_KEY
+The full pipeline runs in one command:
+
+```text
+✔ Scope detected: 22 paths active, 0 watched
+✔ File tree built
+✔ Extracted 43 files
+✔ Git: main - feat: add restaking module
+✔ References: 3 fetched, 0 failed
+✔ Found 94 gaps (9 high priority)
+✔ Dependency map: 70 edges, 13 external packages
+✔ Context document built
+✔ Repository registered with Cliper
+✔ Cognee memory updated
 ```
 
----
+What happened:
 
-## Usage
+1. **Scope detection** - git activity analysis determines which paths matter; manual additions via `cliper scope` are preserved and merged.
+2. **Extraction** - file tree annotation, source content extraction (default cap 50KB per file, configurable with `--max-file-size`), semantic labeling of what each file *does*.
+3. **Intelligence passes** - dependency graph construction (internal edges + external packages), gap detection (undocumented patterns, ranked by severity), git context (commits, branch state), GitHub context (issues, pull requests), external reference resolution.
+4. **Memory build** - everything is converted into typed, self-describing memory objects (see [Memory Types](#memory-types)) with explicit relationships.
+5. **Sync** - memories are uploaded to your Cognee dataset (`cliper-<project>`) in parallel batches, then *cognified* into a knowledge graph. Chunked upload is deliberate: it keeps each ingestion unit small enough for Cognee's extraction pipeline to process reliably on real-world repositories.
+6. **Local artifact** - a complete context document is written to `.cliper/context.md` for direct use with any LLM.
 
-Initialize repository memory.
+### 3. Use the memory
 
-```bash
-npm run build
+**Paste context anywhere:**
 
-node dist/index.js init
+```bash
+cliper export | pbcopy        # macOS
+cliper export | xclip         # Linux
 ```
 
-The repository will be analyzed and converted into structured memories before being synchronized with the configured memory provider.
-
----
+**Query the graph** (via the Cognee search API, `GRAPH_COMPLETION` mode - this is what powers the Cliper mobile app's Ask mode):
 
+```text
+How is authentication implemented?
+Which modules use the config loader?
+What are the highest-priority gaps in this codebase?
+How does the auth command relate to the init command?
+```
 
-## How It Works
+Because memories are graph-connected rather than embedded in isolation, relationship questions ("how does X relate to Y", "what depends on Z") resolve through actual graph traversal instead of keyword proximity.
 
-Once Cliper Memory is configured, onboarding a repository is a single command.
+**Connect a coding agent:**
 
 ```bash
-cliper init
+cliper agent connect
 ```
 
-During initialization, Cliper Memory:
-
-1. Scans the repository structure.
-2. Extracts source code metadata.
-3. Builds dependency and architecture relationships.
-4. Analyzes Git history.
-5. Detects repository gaps.
-6. Converts everything into structured memory objects.
-7. Uploads the memories to the configured Cognee dataset.
-
-Once synchronized, the repository becomes a persistent knowledge graph stored in the user's Cognee cloud, allowing AI applications to query repository knowledge without repeatedly processing the entire codebase.
+Detects locally installed agents (Claude Code, Codex, Cursor Agent), opens an authenticated WebSocket to the Cliper backend, and registers this machine as online - enabling remote task dispatch from the Cliper mobile app. Code execution always happens on your machine; only memory travels.
 
 ---
 
-## Current Memory Pipeline
+## Memory Types
 
-```
-Repository
-    │
-    ▼
-Repository Scanner
-    │
-    ▼
-Memory Builder
-    │
-    ├── Git Memory
-    ├── File Memory
-    ├── Dependency Memory
-    ├── Architecture Memory
-    ├── Responsibility Memory
-    ├── Package Memory
-    ├── Gap Memory
-    └── Commit Memory
-    │
-    ▼
-Memory Provider
-    │
-    ▼
-Cognee Knowledge Graph
+Cliper does not upload raw files. Each unit of knowledge is a **typed memory object** - titled, tagged, related, and self-describing - so the graph understands *what kind of thing* it is storing:
+
+| Memory Type | What it captures |
+| --- | --- |
+| **Repository Memory** | Identity of the project - name, purpose, top-level shape |
+| **File Summary Memory** | Per-file semantic summary: what the file does, not just its name |
+| **Responsibility Memory** | The role a file/module plays in the system |
+| **Architecture Memory** | Module boundaries, layering, structural patterns |
+| **Dependency Memory** | Internal import edges - who depends on whom |
+| **External Package Memory** | Third-party packages and where they are used |
+| **Git Memory** | Branch state, working tree context |
+| **Commit Memory** | Individual commits with messages, authors, changed files |
+| **Release Memory** | Release points in project history |
+| **Timeline Memory** | The evolution of the repository over time |
+| **Issue Memory** | GitHub issues attached to the repository |
+| **Pull Request Memory** | GitHub PRs with their commit and file linkage |
+
+## Relationship Graph
+
+Memories are connected by explicit, first-class relationships - this is what makes Cliper a knowledge graph rather than a document dump:
+
+```text
+Repository ──▶ Commit          Repository ──▶ Issue
+Repository ──▶ Release         Repository ──▶ Pull Request
+Repository ──▶ Timeline
+
+File ──▶ Dependency            Commit ──▶ Changed Files
+File ──▶ Responsibility        Pull Request ──▶ Commit
+Module ──▶ Architecture        Pull Request ──▶ File
+Package ──▶ Repository         Release ──▶ Commit
 ```
 
----
+A question like *"which files were touched by the PR that changed the auth flow?"* is a two-hop traversal (PR → Commit → Changed Files), not a similarity guess.
 
-## Roadmap
+---
 
-### Phase 1
+## Command Reference
 
-- [x] Repository Memory
-- [x] Git Memory
-- [x] File Memory
-- [x] Dependency Memory
-- [x] Package Memory
-- [x] Gap Memory
-- [x] Responsibility Memory
-- [x] Architecture Memory
-- [x] Commit Memory
+| Command | Description |
+| --- | --- |
+| `cliper init [-p path] [--max-file-size kb]` | Full scan → memory build → Cognee sync → backend registration |
+| `cliper auth [github\|cognee]` | Configure credentials (`~/.cliper/config.json`) |
+| `cliper agent connect` | Register local AI coding agents over WebSocket |
+| `cliper sync` | Refresh stale sections of the context document |
+| `cliper status` | Show what is fresh, stale, and in scope |
+| `cliper scope <add\|remove\|watch\|list> [path]` | Manually steer what gets remembered |
+| `cliper export [--format md\|txt]` | Print the context document to stdout |
+| `cliper analyze --model <claude\|chatgpt>` | Generate a model-optimized prompt from the context |
 
-### Phase 2
+## Configuration
 
-- [ ] Release Memory
-- [ ] GitHub Issue Memory
-- [ ] Pull Request Memory
-- [ ] GitHub Discussion Memory
-- [ ] Timeline Memory
+| Location | Contents |
+| --- | --- |
+| `~/.cliper/config.json` | GitHub token, Cognee credentials (mode `0600`) |
+| `.cliper/context.md` | Generated context document (per repo) |
+| `.cliper/` scope config | Active/watched paths for this repo |
 
-### Phase 3
+Cognee credentials can alternatively be provided via environment: `COGNEE_BASE_URL`, `COGNEE_API_KEY`.
 
-- [ ] Semantic Search
-- [ ] Repository Question Answering
-- [ ] Multi-provider Support
-- [ ] Incremental Memory Updates
-- [ ] Live Repository Synchronization
+`cliper init` automatically appends its artifacts to `.gitignore` and untracks accidentally committed `node_modules`.
 
 ---
 
-## Vision
+## Roadmap
 
-Cliper Memory is the foundation for persistent AI-native software repositories.
+**Done** - repository knowledge graph (all memory types above), GitHub intelligence for issues/PRs, Cognee cloud provider with chunked sync, mobile companion (GitHub sign-in, repository browser, memory chat, live agent presence).
 
-Instead of repeatedly providing repository context to AI assistants, your codebase becomes a continuously synchronized memory graph.
+**In progress** - incremental sync (manifest-based, upload only changed memories), agent task execution pipeline (dispatch from phone → headless agent run → streamed edit/test/commit events).
 
-Our long-term vision is to build a companion application that connects directly to your repository memories stored in Cognee.
+**Planned** - multi-provider support (Neo4j, Memgraph, PostgreSQL + pgvector, Graphiti, LanceDB, local JSON), hybrid semantic search, developer SDK (`new Cliper().search(...)`, `.timeline()`, `.graph()`), team workspaces with cross-repository knowledge graphs, and a full agent ecosystem (refactoring, documentation, security review, PR review).
 
-This will allow developers to:
+## Philosophy
 
-- Chat with their codebase from desktop or mobile.
-- Explore architecture interactively.
-- Ask questions about implementation details.
-- Understand dependencies between modules.
-- Navigate Git history conversationally.
-- Retrieve repository knowledge without cloning the project.
+The memory layer for software engineering. Instead of repeatedly sending repositories to AI models, developers initialize once, sync incrementally, and let AI applications and coding agents understand, search, and evolve software through a persistent knowledge graph.
 
-The goal is to make every software repository accessible through natural language while preserving architectural relationships and engineering context.
+Your code never leaves your machine - only its knowledge does.
 
 ---
 
-## License
-
-MIT
+**License:** MIT · **Issues & source:** [github.com/bristinWild/cliper-sdk](https://github.com/bristinWild/cliper-sdk)

package/dist/api/backend.d.ts

@@ -0,0 +1,12 @@
+export declare function registerRepository(data: {
+    name: string;
+    githubOwner?: string;
+    githubRepo?: string;
+    branch: string;
+    dataset: string;
+}): Promise<unknown>;
+export declare function verifyCliAuth(token: string): Promise<{
+    id: string;
+    username: string;
+}>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/api/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/api/backend.ts"],"names":[],"mappings":"AAIA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,oBAiCA;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAO5F"}

package/dist/api/backend.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRepository = registerRepository;
+exports.verifyCliAuth = verifyCliAuth;
+const config_1 = require("../config/config");
+const API_URL = "http://localhost:4000";
+async function registerRepository(data) {
+    const config = (0, config_1.loadConfig)();
+    const token = config.github?.token;
+    if (!token) {
+        throw new Error("GitHub is not configured. Run `cliper auth github`.");
+    }
+    console.log("Registering repository...");
+    console.log(data);
+    console.log(token);
+    console.log(`${API_URL}/repositories/register`);
+    const res = await fetch(`${API_URL}/repositories/register`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(data),
+    });
+    if (!res.ok) {
+        throw new Error(await res.text());
+    }
+    return await res.json();
+}
+async function verifyCliAuth(token) {
+    const res = await fetch(`${API_URL}/auth/cli`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok)
+        throw new Error(await res.text());
+    return (await res.json());
+}
+//# sourceMappingURL=backend.js.map

package/dist/api/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/api/backend.ts"],"names":[],"mappings":";;AAIA,gDAuCC;AAED,sCAOC;AApDD,6CAA8C;AAE9C,MAAM,OAAO,GAAG,uBAAuB,CAAC;AAEjC,KAAK,UAAU,kBAAkB,CAAC,IAMxC;IACG,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAK5B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACX,qDAAqD,CACxD,CAAC;IACN,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,wBAAwB,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,wBAAwB,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,cAAc,EAAE,kBAAkB;SACrC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAGD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,KAAa;IAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,WAAW,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;KAChD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqC,CAAC;AAClE,CAAC"}

package/dist/auth/github.js

@@ -7,7 +7,7 @@ exports.getGithubToken = getGithubToken;
 exports.saveGithubToken = saveGithubToken;
 exports.hasGithubAuth = hasGithubAuth;
 exports.getGithubHeaders = getGithubHeaders;
-const config_1 = require("./config");
+const config_1 = require("../config/config");
 const chalk_1 = __importDefault(require("chalk"));
 function getGithubToken() {
     return (0, config_1.loadConfig)().github?.token ?? null;

package/dist/auth/github.js.map

@@ -1 +1 @@
-{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":";;;;;AAGA,wCAIC;AAED,0CAYC;AAED,sCAIC;AAED,4CAsBC;AAnDD,qCAAkD;AAClD,kDAA0B;AAE1B,SAAgB,cAAc;IAE1B,OAAO,IAAA,mBAAU,GAAE,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;AAE9C,CAAC;AAED,SAAgB,eAAe,CAC3B,KAAa;IAGb,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAE5B,MAAM,CAAC,MAAM,GAAG;QACZ,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;KACtB,CAAC;IAEF,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;AAEvB,CAAC;AAED,SAAgB,aAAa;IAEzB,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;AAErC,CAAC;AAED,SAAgB,gBAAgB;IAE5B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACP,eAAK,CAAC,MAAM,CACR,6DAA6D,CAChE,CACJ,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAA2B;QACpC,MAAM,EAAE,6BAA6B;KACxC,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AAEnB,CAAC"}
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":";;;;;AAGA,wCAIC;AAED,0CAYC;AAED,sCAIC;AAED,4CAsBC;AAnDD,6CAAyD;AACzD,kDAA0B;AAE1B,SAAgB,cAAc;IAE1B,OAAO,IAAA,mBAAU,GAAE,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;AAE9C,CAAC;AAED,SAAgB,eAAe,CAC3B,KAAa;IAGb,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAE5B,MAAM,CAAC,MAAM,GAAG;QACZ,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;KACtB,CAAC;IAEF,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;AAEvB,CAAC;AAED,SAAgB,aAAa;IAEzB,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;AAErC,CAAC;AAED,SAAgB,gBAAgB;IAE5B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACP,eAAK,CAAC,MAAM,CACR,6DAA6D,CAChE,CACJ,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAA2B;QACpC,MAAM,EAAE,6BAA6B;KACxC,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AAEnB,CAAC"}

package/dist/commands/agent.d.ts

@@ -0,0 +1,2 @@
+export declare function agentCommand(action?: string): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AA2BA,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgEjE"}

package/dist/commands/agent.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentCommand = agentCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const child_process_1 = require("child_process");
+const ws_1 = __importDefault(require("ws"));
+const github_1 = require("../auth/github");
+const WS_URL = "ws://localhost:4000/ws";
+/** Which coding agents are installed on this machine? */
+function detectAgents() {
+    const candidates = [
+        { bin: "claude", name: "Claude Code" },
+        { bin: "codex", name: "Codex CLI" },
+        { bin: "cursor-agent", name: "Cursor Agent" },
+    ];
+    return candidates
+        .filter(({ bin }) => {
+        try {
+            (0, child_process_1.execSync)(`which ${bin}`, { stdio: "ignore" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    })
+        .map(({ name }) => name);
+}
+async function agentCommand(action) {
+    if (action !== "connect") {
+        console.log(chalk_1.default.red(`Unknown action: ${action ?? "(none)"} — try: cliper agent connect`));
+        return;
+    }
+    const token = (0, github_1.getGithubToken)();
+    if (!token) {
+        console.log(chalk_1.default.yellow("Not authenticated. Run: cliper auth github"));
+        return;
+    }
+    console.log(chalk_1.default.bold.cyan("\n  cliper agent\n"));
+    const agents = detectAgents();
+    if (agents.length === 0) {
+        console.log(chalk_1.default.yellow("  ⚠ No coding agents detected (looked for claude, codex, cursor-agent)"));
+    }
+    else {
+        agents.forEach((a) => console.log(chalk_1.default.green(`  ✓ ${a} detected`)));
+    }
+    const spinner = (0, ora_1.default)("Connecting to Cliper cloud...").start();
+    let heartbeat = null;
+    const connect = () => {
+        const ws = new ws_1.default(WS_URL, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        ws.on("open", () => {
+            spinner.succeed(chalk_1.default.green("Connected to Cliper cloud"));
+            ws.send(JSON.stringify({ type: "agent:register", agents }));
+            console.log(chalk_1.default.gray("\n  Agent is online. Your phone can now see this machine."));
+            console.log(chalk_1.default.gray("  Waiting for tasks... (Ctrl+C to disconnect)\n"));
+            heartbeat = setInterval(() => ws.ping(), 20000);
+        });
+        ws.on("message", (raw) => {
+            try {
+                const msg = JSON.parse(raw.toString());
+                if (msg.type === "task") {
+                    console.log(chalk_1.default.bold.magenta(`  → Task received: ${msg.prompt}`));
+                    console.log(chalk_1.default.gray("    (execution pipeline coming soon — acknowledging)"));
+                    ws.send(JSON.stringify({ type: "task:ack", taskId: msg.taskId }));
+                }
+            }
+            catch {
+                /* ignore malformed frames */
+            }
+        });
+        ws.on("close", () => {
+            if (heartbeat)
+                clearInterval(heartbeat);
+            console.log(chalk_1.default.yellow("\n  Disconnected — retrying in 3s..."));
+            setTimeout(connect, 3000);
+        });
+        ws.on("error", (err) => {
+            spinner.fail(chalk_1.default.red(`Connection failed: ${err.message}`));
+            // 'close' fires after 'error' and handles the retry.
+        });
+    };
+    connect();
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/auth.d.ts

@@ -1,3 +1,2 @@
 export declare function authCommand(provider?: string): Promise<void>;
-export declare function getAuthToken(): string | null;
 //# sourceMappingURL=auth.d.ts.map

package/dist/commands/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AASA,wBAAsB,WAAW,CAC7B,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAKA,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BlE"}