diff --git a/.env.example b/.env.example index c9a6220..55e33ca 100644 --- a/.env.example +++ b/.env.example @@ -1,4 +1,4 @@ -# Android Action Kernel Configuration (TypeScript/Bun) +# DroidClaw Configuration (TypeScript/Bun) # Copy this file to .env and fill in your settings # cp .env.example .env diff --git a/CLAUDE.md b/CLAUDE.md index 34c9622..cebefdc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Project Overview -Android Action Kernel — an AI agent that controls Android devices through the Accessibility API. It runs a Perception → Reasoning → Action loop: captures the screen state via `uiautomator dump`, sends it to an LLM for decision-making, and executes the chosen action via ADB. +DroidClaw — an AI agent that controls Android devices through the Accessibility API. It runs a Perception → Reasoning → Action loop: captures the screen state via `uiautomator dump`, sends it to an LLM for decision-making, and executes the chosen action via ADB. **Runtime:** Bun (TypeScript, ES2022 modules). Bun natively loads `.env` files — no dotenv needed. diff --git a/README.md b/README.md index 2cd6b4b..7c7fc91 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Android Action Kernel +# DroidClaw An AI agent that takes control of your Android phone. You give it a goal in plain English — "order me a coffee on Swiggy" or "turn on dark mode" — and it figures out what to tap, type, and swipe to get it done. @@ -13,7 +13,7 @@ $ bun run src/kernel.ts Enter your goal: Open YouTube and search for "lofi hip hop" Screen resolution: 1080x2400 -Android Action Kernel Started +DroidClaw Started Goal: Open YouTube and search for "lofi hip hop" Provider: groq (llama-3.3-70b-versatile) Max steps: 30 | Step delay: 2s diff --git a/docs/adb-commands.md b/docs/adb-commands.md index eb73802..6cb4444 100644 --- a/docs/adb-commands.md +++ b/docs/adb-commands.md @@ -4,7 +4,7 @@ Complete reference of all ADB shell commands available for Android device automa --- -## Currently Implemented in Android Action Kernel +## Currently Implemented in DroidClaw | Command | Action | Description | |---|---|---| diff --git a/docs/capabilities-and-limitations.md b/docs/capabilities-and-limitations.md index ccf5325..3526807 100644 --- a/docs/capabilities-and-limitations.md +++ b/docs/capabilities-and-limitations.md @@ -1,4 +1,4 @@ -# Android Action Kernel — Capabilities & Limitations +# DroidClaw — Capabilities & Limitations ## Built-in Actions (15) diff --git a/docs/use-cases.md b/docs/use-cases.md index a5db8f2..963e21e 100644 --- a/docs/use-cases.md +++ b/docs/use-cases.md @@ -1,4 +1,4 @@ -# Android Action Kernel — Use Cases +# DroidClaw — Use Cases Real-world scenarios the agent can handle, organized by category. Each use case includes the goal you'd give the agent and the actions it would take. diff --git a/package.json b/package.json index b0820fe..10a34cd 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { - "name": "android-action-kernel", + "name": "droidclaw", "version": "1.0.0", - "description": "AI agent that controls Android devices through the accessibility API - TypeScript/Bun edition", + "description": "AI agent that takes control of your Android phone — give it a goal, it figures out the taps", "type": "module", "scripts": { "start": "bun run src/kernel.ts", diff --git a/src/actions.ts b/src/actions.ts index 8723704..445ae80 100644 --- a/src/actions.ts +++ b/src/actions.ts @@ -1,5 +1,5 @@ /** - * Action execution module for Android Action Kernel. + * Action execution module for DroidClaw. * Handles all ADB commands for interacting with Android devices. * * Supported actions: diff --git a/src/config.ts b/src/config.ts index 11cce55..bab0daa 100644 --- a/src/config.ts +++ b/src/config.ts @@ -1,5 +1,5 @@ /** - * Configuration management for Android Action Kernel. + * Configuration management for DroidClaw. * Bun natively loads .env files — no dotenv needed. */ diff --git a/src/constants.ts b/src/constants.ts index e2414ff..e52d5c7 100644 --- a/src/constants.ts +++ b/src/constants.ts @@ -1,5 +1,5 @@ /** - * Constants for Android Action Kernel. + * Constants for DroidClaw. * All magic strings, URLs, and fixed values in one place. */ diff --git a/src/kernel.ts b/src/kernel.ts index db96018..fc52356 100644 --- a/src/kernel.ts +++ b/src/kernel.ts @@ -1,5 +1,5 @@ /** - * Android Action Kernel - Main Agent Loop (TypeScript/Bun Edition) + * DroidClaw - Main Agent Loop (TypeScript/Bun Edition) * * An AI agent that controls Android devices through the accessibility API. * Uses LLMs to make decisions based on screen context. @@ -202,7 +202,7 @@ async function runAgent(goal: string, maxSteps?: number): Promise { console.log("Screen resolution: using default 1080x2400 swipe coords"); } - console.log("Android Action Kernel Started"); + console.log("DroidClaw Started"); console.log(`Goal: ${goal}`); console.log(`Provider: ${Config.LLM_PROVIDER} (${Config.getModel()})`); console.log(`Max steps: ${steps} | Step delay: ${Config.STEP_DELAY}s`); diff --git a/src/llm-providers.ts b/src/llm-providers.ts index 18b3e17..b8f334f 100644 --- a/src/llm-providers.ts +++ b/src/llm-providers.ts @@ -1,5 +1,5 @@ /** - * LLM Provider module for Android Action Kernel. + * LLM Provider module for DroidClaw. * Supports OpenAI, Groq, AWS Bedrock, and OpenRouter (via Vercel AI SDK). * * Phase 3: Real multimodal vision (image content parts) diff --git a/src/logger.ts b/src/logger.ts index 51199c9..a1065cb 100644 --- a/src/logger.ts +++ b/src/logger.ts @@ -1,5 +1,5 @@ /** - * Session logging for Android Action Kernel. + * Session logging for DroidClaw. * Writes incremental .partial.json after each step (crash-safe), * and a final .json summary at session end. */ diff --git a/src/sanitizer.ts b/src/sanitizer.ts index 2ec1fed..de13dec 100644 --- a/src/sanitizer.ts +++ b/src/sanitizer.ts @@ -1,5 +1,5 @@ /** - * XML Sanitizer for Android Action Kernel. + * XML Sanitizer for DroidClaw. * Parses Android Accessibility XML and extracts interactive UI elements * with full state information and parent-child hierarchy context. */