@artyfacts/claude 1.0.0

package/README.md

@@ -0,0 +1,135 @@
+# @artyfacts/claude
+
+Run AI agents locally using Claude Code, orchestrated by Artyfacts.
+
+## Quick Start
+
+```bash
+npx @artyfacts/claude
+```
+
+That's it. The CLI will:
+1. Open your browser to log in (first time only)
+2. Check Claude Code is installed
+3. Start polling for tasks from artyfacts.dev
+4. Execute tasks locally with Claude Code
+
+## Prerequisites
+
+**Claude Code** must be installed:
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude login
+```
+
+## How It Works
+
+```
+artyfacts.dev                Your Machine
+─────────────                ────────────
+Create goal          
+Create tasks    ──────────>  npx @artyfacts/claude
+                             │
+                             ├─ Polls for tasks
+                             ├─ Claims task
+                             ├─ Runs: claude -p "task..."
+                             ├─ Reports completion
+                             │
+Task complete!  <──────────  Next task...
+```
+
+## Commands
+
+```bash
+# Start the adapter (default)
+npx @artyfacts/claude
+
+# Check status
+npx @artyfacts/claude status
+
+# Log in manually
+npx @artyfacts/claude login
+
+# Log out
+npx @artyfacts/claude logout
+
+# Show current user
+npx @artyfacts/claude whoami
+```
+
+## Options
+
+```bash
+npx @artyfacts/claude [options]
+
+  -i, --interval <sec>    Poll interval in seconds (default: 30)
+  -c, --concurrent <n>    Max concurrent tasks (default: 1)
+  -m, --model <model>     Claude model: sonnet, opus (default: sonnet)
+  -d, --cwd <dir>         Working directory
+```
+
+## Example Session
+
+```
+$ npx @artyfacts/claude
+
+🚀 Artyfacts + Claude Code
+
+🔗 Opening browser to log in...
+
+  https://artyfacts.dev/auth/device?code=ABCD-1234
+
+  Your code: ABCD-1234
+
+  Waiting for authorization...
+
+✓ Logged in as gracie@example.com
+
+Checking Claude Code...
+✓ Claude Code 2.1.22
+
+✓ Started
+  Polling every 30s
+  Model: sonnet
+
+Waiting for tasks from artyfacts.dev...
+Create goals and tasks at https://artyfacts.dev
+
+▶ Research competitor pricing
+  From: Q2 Growth Strategy
+  Running with Claude...
+✓ Completed
+  Duration: 45.2s
+```
+
+## Programmatic Usage
+
+```typescript
+import { ClaudeAdapter, DeviceAuth } from '@artyfacts/claude';
+
+const auth = new DeviceAuth();
+
+// Ensure logged in
+if (!auth.hasCredentials()) {
+  await auth.login();
+}
+
+const adapter = new ClaudeAdapter({
+  apiKey: auth.getAccessToken()!,
+});
+
+adapter.on('task:completed', (task) => {
+  console.log(`Done: ${task.heading}`);
+});
+
+await adapter.start();
+```
+
+## Credentials
+
+Stored in `~/.artyfacts/credentials.json` with 600 permissions (user read/write only).
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli.mjs');