Rename project to DroidClaw
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -1,4 +1,4 @@
|
|||||||
# Android Action Kernel Configuration (TypeScript/Bun)
|
# DroidClaw Configuration (TypeScript/Bun)
|
||||||
# Copy this file to .env and fill in your settings
|
# Copy this file to .env and fill in your settings
|
||||||
# cp .env.example .env
|
# cp .env.example .env
|
||||||
|
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|||||||
|
|
||||||
## Project Overview
|
## 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.
|
**Runtime:** Bun (TypeScript, ES2022 modules). Bun natively loads `.env` files — no dotenv needed.
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
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"
|
Enter your goal: Open YouTube and search for "lofi hip hop"
|
||||||
|
|
||||||
Screen resolution: 1080x2400
|
Screen resolution: 1080x2400
|
||||||
Android Action Kernel Started
|
DroidClaw Started
|
||||||
Goal: Open YouTube and search for "lofi hip hop"
|
Goal: Open YouTube and search for "lofi hip hop"
|
||||||
Provider: groq (llama-3.3-70b-versatile)
|
Provider: groq (llama-3.3-70b-versatile)
|
||||||
Max steps: 30 | Step delay: 2s
|
Max steps: 30 | Step delay: 2s
|
||||||
|
|||||||
@@ -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 |
|
| Command | Action | Description |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# Android Action Kernel — Capabilities & Limitations
|
# DroidClaw — Capabilities & Limitations
|
||||||
|
|
||||||
## Built-in Actions (15)
|
## Built-in Actions (15)
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
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.
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "android-action-kernel",
|
"name": "droidclaw",
|
||||||
"version": "1.0.0",
|
"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",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "bun run src/kernel.ts",
|
"start": "bun run src/kernel.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.
|
* Handles all ADB commands for interacting with Android devices.
|
||||||
*
|
*
|
||||||
* Supported actions:
|
* Supported actions:
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Configuration management for Android Action Kernel.
|
* Configuration management for DroidClaw.
|
||||||
* Bun natively loads .env files — no dotenv needed.
|
* Bun natively loads .env files — no dotenv needed.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Constants for Android Action Kernel.
|
* Constants for DroidClaw.
|
||||||
* All magic strings, URLs, and fixed values in one place.
|
* All magic strings, URLs, and fixed values in one place.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
* An AI agent that controls Android devices through the accessibility API.
|
||||||
* Uses LLMs to make decisions based on screen context.
|
* Uses LLMs to make decisions based on screen context.
|
||||||
@@ -202,7 +202,7 @@ async function runAgent(goal: string, maxSteps?: number): Promise<void> {
|
|||||||
console.log("Screen resolution: using default 1080x2400 swipe coords");
|
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(`Goal: ${goal}`);
|
||||||
console.log(`Provider: ${Config.LLM_PROVIDER} (${Config.getModel()})`);
|
console.log(`Provider: ${Config.LLM_PROVIDER} (${Config.getModel()})`);
|
||||||
console.log(`Max steps: ${steps} | Step delay: ${Config.STEP_DELAY}s`);
|
console.log(`Max steps: ${steps} | Step delay: ${Config.STEP_DELAY}s`);
|
||||||
|
|||||||
@@ -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).
|
* Supports OpenAI, Groq, AWS Bedrock, and OpenRouter (via Vercel AI SDK).
|
||||||
*
|
*
|
||||||
* Phase 3: Real multimodal vision (image content parts)
|
* Phase 3: Real multimodal vision (image content parts)
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* Session logging for Android Action Kernel.
|
* Session logging for DroidClaw.
|
||||||
* Writes incremental .partial.json after each step (crash-safe),
|
* Writes incremental .partial.json after each step (crash-safe),
|
||||||
* and a final .json summary at session end.
|
* and a final .json summary at session end.
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/**
|
/**
|
||||||
* XML Sanitizer for Android Action Kernel.
|
* XML Sanitizer for DroidClaw.
|
||||||
* Parses Android Accessibility XML and extracts interactive UI elements
|
* Parses Android Accessibility XML and extracts interactive UI elements
|
||||||
* with full state information and parent-child hierarchy context.
|
* with full state information and parent-child hierarchy context.
|
||||||
*/
|
*/
|
||||||
|
|||||||
Reference in New Issue
Block a user