vibekit-agent 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# vibekit-agent
+
+Control your local Claude Code from Telegram. Ship code from your phone.
+
+**Free to use** - works with your existing Claude Pro/Max subscription.
+
+## Installation
+
+```bash
+npm install -g vibekit-agent
+```
+
+## Quick Start
+
+1. **Get a link code from Telegram:**
+   - Open [@the_vibe_kit_bot](https://t.me/the_vibe_kit_bot)
+   - Send `/remote` to get your link code
+
+2. **Link your computer:**
+   ```bash
+   npx vibekit-agent link
+   ```
+   Enter the code when prompted.
+
+3. **Start the agent:**
+   ```bash
+   npx vibekit-agent start
+   ```
+
+4. **Send messages via Telegram** - they'll be executed by Claude Code on your machine.
+
+## Features
+
+- **Text messages** - Chat naturally, Claude responds
+- **Voice messages** - Send voice notes, Claude listens and responds
+- **Images & screenshots** - Send photos for analysis or debugging
+- **Document uploads** - Share files for Claude to work with
+- **Conversation memory** - Claude remembers context within a session
+
+## Telegram Commands
+
+Once connected, use these commands in the bot:
+
+| Command | Description |
+|---------|-------------|
+| `/remote` | View status, new chat, disconnect |
+| `/stop` | Cancel running task |
+| `/status` | View connection status |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `vibekit-agent link` | Link this computer to your Telegram account |
+| `vibekit-agent start` | Start the remote agent |
+| `vibekit-agent start -d /path/to/project` | Start in a specific directory |
+| `vibekit-agent status` | Show connection status |
+| `vibekit-agent logout` | Remove stored credentials |
+| `vibekit-agent config` | View current configuration |
+
+## Tool Permissions
+
+By default, the agent runs with a safe set of read-only tools. You can configure which tools Claude Code can use:
+
+```bash
+# View current tools
+vibekit-agent config
+
+# Set specific tools
+vibekit-agent config --tools "WebSearch,Bash,Read,Write,Edit"
+
+# Reset to safe defaults
+vibekit-agent config --reset-tools
+
+# Enable all tools (use with caution)
+vibekit-agent config --all-tools
+```
+
+**Default safe tools:** WebSearch, WebFetch, Read, Glob, Grep
+
+**Available tools:** WebSearch, WebFetch, Bash, Read, Write, Edit, Glob, Grep
+
+## How It Works
+
+1. The agent runs on your local machine
+2. It connects to VibeKit's server via WebSocket
+3. When you send a message via Telegram, it's relayed to your local agent
+4. Claude Code executes the request and sends results back to Telegram
+
+## Requirements
+
+- Node.js 18+
+- Claude Code CLI installed (`npm install -g @anthropic-ai/claude-code`)
+- A VibeKit account (free to start)
+
+## Troubleshooting
+
+**"No token found"** - Run `vibekit-agent link` first
+
+**"Connection lost"** - Check your internet connection and restart with `vibekit-agent start`
+
+**"Claude Code not found"** - Install Claude Code: `npm install -g @anthropic-ai/claude-code`
+
+## Links
+
+- [VibeKit Website](https://vibekit.dev)
+- [Telegram Bot](https://t.me/the_vibe_kit_bot)
+- [GitHub](https://github.com/609NFT/vibekit)
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,105 @@
+import { Config } from './config';
+export declare class AgentClient {
+    private config;
+    private ws;
+    private claudeProcess;
+    private reconnectTimeout;
+    private reconnectDelay;
+    private isConnected;
+    private currentChatId;
+    private currentTelegramId;
+    private currentReplyToMessageId;
+    private outputBuffer;
+    private streamingInterval;
+    private lastFlushedLength;
+    private currentMessageId;
+    private workingDirectory;
+    private hasActiveConversation;
+    constructor(config: Config);
+    /**
+     * Link this computer to a Telegram account
+     */
+    link(): Promise<void>;
+    /**
+     * Start the agent and connect to VibeKit
+     */
+    start(directory: string, autoMode?: boolean): Promise<void>;
+    /**
+     * Run claude command with the given prompt
+     */
+    private runClaude;
+    /**
+     * Start streaming interval to send partial output
+     */
+    private startStreaming;
+    /**
+     * Stop streaming interval
+     */
+    private stopStreaming;
+    /**
+     * Flush partial output if buffer has grown since last flush
+     */
+    private flushPartialOutput;
+    /**
+     * Flush final buffered output to Telegram
+     */
+    private flushOutput;
+    /**
+     * Connect to VibeKit WebSocket server
+     */
+    private connect;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleMessage;
+    /**
+     * Handle user message from Telegram
+     */
+    private handleUserMessage;
+    /**
+     * Save attachments to temp directory and return file paths
+     */
+    private saveAttachments;
+    /**
+     * Handle new conversation command - reset conversation memory
+     */
+    private handleNewConversation;
+    /**
+     * Handle change directory command
+     */
+    private handleCdCommand;
+    /**
+     * Send streaming update to Telegram
+     */
+    private sendStreaming;
+    /**
+     * Send a response back to Telegram
+     */
+    private sendResponse;
+    /**
+     * Send status update
+     */
+    private sendStatus;
+    /**
+     * Send a message to the WebSocket
+     */
+    private send;
+    /**
+     * Schedule reconnection
+     */
+    private scheduleReconnect;
+    /**
+     * Generate a unique message ID
+     */
+    private generateId;
+    /**
+     * Shutdown the agent
+     */
+    private shutdown;
+    /**
+     * Set up Claude credentials for auto mode
+     * In auto mode, credentials come from CLAUDE_OAUTH_JSON env var or credentials file
+     */
+    private setupAutoModeCredentials;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAsIlC,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,gBAAgB,CAAyB;IAGjD,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+D3B;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCxE;;OAEG;IACH,OAAO,CAAC,SAAS;IAmGjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAoDf;;OAEG;IACH,OAAO,CAAC,aAAa;IA+CrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmCvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;;OAGG;YACW,wBAAwB;CA+CvC"}