npm - forkoff - Versions diffs - 1.0.18 → 1.0.19 - Mend

forkoff 1.0.18 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/LICENSE CHANGED Viewed

@@ -1,12 +1,16 @@
-Copyright (c) 2026 ForkOff. All rights reserved.
+MIT License
-This software and associated documentation files (the "Software") are the
-proprietary property of ForkOff. The Software is provided for viewing and
-reference purposes only.
+Copyright (c) 2026 ForkOff
-No part of the Software may be copied, modified, merged, published,
-distributed, sublicensed, sold, or otherwise used without the prior written
-permission of ForkOff.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

package/README.md CHANGED Viewed

@@ -5,37 +5,31 @@
 <h1 align="center">ForkOff CLI</h1>
 <p align="center">
-  <strong>Bridge your AI coding tools to your mobile device</strong>
+  <strong>Control your AI coding sessions from your phone</strong>
 </p>
-> ## 🚀 **OPEN BETA**
->
-> ForkOff is now in **open beta**! Download the mobile app and get started:
->
-> 📱 **[Join the TestFlight Beta](https://testflight.apple.com/join/dhh5FrN7)**
----
+<p align="center">
+  <a href="https://www.npmjs.com/package/forkoff"><img src="https://img.shields.io/npm/v/forkoff.svg" alt="npm version"></a>
+  <a href="https://github.com/Forkoff-app/forkoff-cli/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/forkoff.svg" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/forkoff"><img src="https://img.shields.io/npm/dm/forkoff.svg" alt="npm downloads"></a>
+</p>
 <p align="center">
-  <a href="https://forkoff.app">Website</a> •
-  <a href="#installation">Installation</a> •
-  <a href="#quick-start">Quick Start</a> •
-  <a href="#commands">Commands</a> •
-  <a href="#programmatic-usage">API</a> •
-  <a href="#configuration">Configuration</a>
+  <a href="https://forkoff.app">Website</a> &bull;
+  <a href="#installation">Installation</a> &bull;
+  <a href="#quick-start">Quick Start</a> &bull;
+  <a href="#commands">Commands</a> &bull;
+  <a href="#programmatic-usage">API</a> &bull;
+  <a href="#security">Security</a>
 </p>
 ---
-## Overview
+ForkOff CLI connects [Claude Code](https://claude.ai/code) on your laptop to the ForkOff mobile app, giving you real-time monitoring, interactive approvals, and usage analytics from anywhere.
-ForkOff CLI connects your development machine to the ForkOff mobile app, enabling you to:
-- **Control AI coding sessions** from your phone
-- **Approve code changes** on the go
-- **Send prompts** to Claude, Cursor, and other AI tools
-- **Monitor progress** in real-time
-- **Get notifications** for permission requests
+> **Open Source** &mdash; ForkOff CLI is now MIT licensed. Contributions welcome!
+>
+> **Open Beta** &mdash; [Join the iOS TestFlight](https://testflight.apple.com/join/dhh5FrN7)
 ## Installation
@@ -45,24 +39,35 @@ npm install -g forkoff
 ## Quick Start
-### 1. Pair with Mobile App
+### 1. Pair with your phone
 ```bash
 forkoff pair
 ```
-Scan the QR code with your ForkOff mobile app to link your device.
+Scan the QR code with the ForkOff mobile app to link your device.
-### 2. Stay Connected
+### 2. Stay connected
 ```bash
 forkoff connect
 ```
-Keep this running to receive commands from your mobile app.
+Keep this running to stream sessions to your phone in real-time.
 ---
+## Features
+- **Real-time session monitoring** &mdash; See Claude Code output on your phone as it happens
+- **Interactive approvals** &mdash; Approve or deny tool use (file edits, bash commands) from mobile
+- **Configurable permission rules** &mdash; Auto-approve safe tools, require approval for destructive ones
+- **End-to-end encryption** &mdash; All session data encrypted between CLI and mobile
+- **Usage analytics** &mdash; Track token usage, session counts, and streaks across devices
+- **Multi-device support** &mdash; Connect multiple CLI instances, analytics aggregate automatically
+- **Auto-start** &mdash; Optionally launch on login so your phone is always connected
+- **Direct P2P connection** &mdash; Embedded relay server, no cloud dependency for session data
 ## Commands
 | Command | Description |
@@ -70,31 +75,18 @@ Keep this running to receive commands from your mobile app.
 | `forkoff pair` | Generate QR code to pair with mobile app |
 | `forkoff connect` | Connect and listen for commands |
 | `forkoff status` | Check connection status |
-| `forkoff disconnect` | Disconnect from server |
+| `forkoff disconnect` | Disconnect and unpair device |
 | `forkoff config` | View/modify configuration |
 | `forkoff startup` | Manage automatic startup on login |
-| `forkoff startup --enable` | Enable automatic startup |
-| `forkoff startup --disable` | Disable automatic startup |
-| `forkoff startup --status` | Show startup registration status |
-| `forkoff help` | Show available commands and usage |
+| `forkoff tools` | Detect AI coding tools on your machine |
+| `forkoff logs` | List debug log files for troubleshooting |
-### Configuration Options
+### Configuration
 ```bash
-# Show current configuration
-forkoff config --show
-# Set custom API URL
-forkoff config --api https://your-server.com/api
-# Set custom WebSocket URL
-forkoff config --ws wss://your-server.com
-# Set device name
-forkoff config --name "My MacBook Pro"
-# Reset all configuration
-forkoff config --reset
+forkoff config --show            # Show current config
+forkoff config --name "My MBP"   # Set device name
+forkoff config --reset           # Reset to defaults
 ```
 ### Global Options
@@ -102,93 +94,64 @@ forkoff config --reset
 | Option | Description |
 |--------|-------------|
 | `-q, --quiet` | Suppress all output (for background operation) |
-### Background Operation
-Run ForkOff silently in the background with no console output:
-```bash
-forkoff connect --quiet
-```
-This is used by the automatic startup feature and is useful for running ForkOff as a background service.
+| `--debug` | Enable debug logging to file (`~/.forkoff-cli/logs/`) |
 ### Automatic Startup
-ForkOff automatically starts on login so your device stays connected without manual intervention. Startup is **enabled by default** — when you run `forkoff pair` or `forkoff connect`, it registers itself to launch `forkoff connect --quiet` on login.
+Startup is enabled by default &mdash; `forkoff pair` and `forkoff connect` register the CLI to launch on login.
-- **Windows**: Adds a `ForkOffCLI` entry to the `HKCU\...\Run` registry key (no admin required)
-- **macOS**: Installs a launchd agent (`~/Library/LaunchAgents/app.forkoff.cli.plist`) with the explicit node binary path for nvm/fnm compatibility
-To disable automatic startup:
+- **Windows**: Registry key (`HKCU\...\Run`)
+- **macOS**: launchd agent (`~/Library/LaunchAgents/app.forkoff.cli.plist`)
 ```bash
-forkoff startup --disable
+forkoff startup --disable   # Disable auto-start
+forkoff startup --enable    # Re-enable
+forkoff startup --status    # Check registration
 ```
-Once disabled, `pair` and `connect` will not re-register startup. To re-enable:
+---
+## Security
-```bash
-forkoff startup --enable
-```
+All communication between the CLI and mobile app is end-to-end encrypted. The relay server never sees plaintext session data.
+| Layer | Implementation |
+|-------|---------------|
+| **Key exchange** | X25519 ECDH with Ed25519 identity signatures |
+| **Encryption** | XSalsa20-Poly1305 authenticated encryption (NaCl) |
+| **Identity** | TOFU (Trust On First Use) with key pinning |
+| **Replay protection** | Per-peer monotonic message counters |
+| **Key storage** | OS keychain (macOS Keychain, Windows Credential Manager, Linux libsecret) |
+| **Enforcement** | Sensitive events (session content, approvals, files) never sent in plaintext |
-Running `forkoff disconnect` also removes the startup registration.
+No additional setup required &mdash; E2EE is enabled automatically when you pair.
 ---
 ## Programmatic Usage
-Integrate ForkOff into your AI coding tools:
+Integrate ForkOff into your own AI coding tools:
 ```typescript
 import { createIntegration } from 'forkoff';
 const forkoff = createIntegration();
-// Connect to ForkOff server
 await forkoff.connect();
-// Handle incoming messages from mobile app
-forkoff.onMessageReceived((sessionId, content, requestedBy) => {
-  console.log(`Message from ${requestedBy}: ${content}`);
-  // Send a response
-  forkoff.sendMessage(sessionId, 'Processing your request...');
-});
-// Stream responses in real-time
-const stream = forkoff.startStreaming(sessionId);
-stream.write('Here is ');
-stream.write('a streaming ');
-stream.write('response.');
-stream.end();
 // Request approval for code changes
 const approval = await forkoff.requestApproval(
-  sessionId,
-  messageId,
-  'CODE_CHANGE',
-  'Add authentication middleware',
+  sessionId, messageId, 'CODE_CHANGE',
+  'Add auth middleware',
   { filePath: 'src/middleware/auth.ts', diff: '...' }
 );
-if (approval.status === 'approved') {
-  // Apply the changes
-}
-// Send terminal output
-forkoff.sendTerminalOutput(sessionId, '> npm install\n Done', 'stdout');
-forkoff.sendTerminalExit(sessionId, 0);
-// Update device status
-forkoff.setStatus('busy');
+// Stream terminal output
+forkoff.sendTerminalOutput(sessionId, '> npm install\nDone', 'stdout');
 ```
 ---
-## Configuration
-Configuration files are stored at:
+## Configuration Files
 | Platform | Location |
 |----------|----------|
@@ -196,26 +159,22 @@ Configuration files are stored at:
 | **macOS** | `~/Library/Preferences/forkoff-cli/config.json` |
 | **Linux** | `~/.config/forkoff-cli/config.json` |
----
-## Security
-Your data stays yours. All communication between the ForkOff CLI and your mobile device is protected with **end-to-end encryption (E2EE)**:
-- Messages, code, and commands are encrypted on-device before leaving your machine
-- The ForkOff server never sees your plaintext data — it only relays encrypted payloads
-- Each device pair establishes a unique encrypted channel using ephemeral key exchange
-- Session keys are derived per-connection, so even if one session is compromised, others remain secure
+## Development
-No additional setup required — E2EE is enabled automatically when you pair your device.
+```bash
+git clone https://github.com/Forkoff-app/forkoff-cli.git
+cd forkoff-cli
+npm install
+npm run dev       # Run with ts-node
+npm run build     # Compile TypeScript
+npm test          # Run tests
+```
 ## Requirements
 - Node.js 18+
-- ForkOff mobile app
+- [ForkOff mobile app](https://testflight.apple.com/join/dhh5FrN7) (iOS)
----
+## License
-<p align="center">
-  Made with ❤️ by the ForkOff team
-</p>
+[MIT](LICENSE)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "forkoff",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "CLI tool to connect your AI coding tools to mobile | Open Beta - Download the app: https://testflight.apple.com/join/dhh5FrN7",
   "main": "dist/integration.js",
   "types": "dist/integration.d.ts",
@@ -48,7 +48,7 @@
     "email": "support@forkoff.app",
     "url": "https://forkoff.app"
   },
-  "license": "Proprietary",
+  "license": "MIT",
   "dependencies": {
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",