Skip to content

appclawhq/AppClaw

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

108 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppClaw

AI-powered mobile automation agent for Android and iOS. Tell it what to do in plain English — it figures out what to tap, type, and swipe.

AppClaw demo
You: "Send a WhatsApp message to Mom
      saying good morning"

AppClaw:
  Step 1: Open WhatsApp
  Step 2: Search for Mom
  Step 3: Open chat with Mom
  Step 4: Type "good morning"
  Step 5: Tap Send
  Step 6: Done

  ✅ Goal completed in 6 steps.

📖 Full guide, setup, and docs → appclaw.in

Quickstart

npm install -g @appclaw/cli
appclaw "open the settings app and turn on airplane mode"

You'll need Node.js 22+, a connected device / emulator / simulator, and an LLM API key (Anthropic, OpenAI, Google, Groq, or local Ollama). Full setup → appclaw.in.

What it can do

  • Agent mode — plain-English goals; the LLM drives the device (tap, type, swipe)
  • YAML flows — deterministic, zero-LLM automation
  • Test runner — vitest-style specs across real devices; scaffold with appclaw init
  • SDK — drive AppClaw from your own vitest / jest / mocha
  • Playground, cloud devices, record & replay, PRD explorer, and more

Every mode is documented at appclaw.in.

Packages

Install Package For
npm i -g @appclaw/cli @appclaw/cli the appclaw command — goals, flows, playground, reports
via appclaw init @appclaw/runner vitest-style test runner (appclaw-runner)
npm i @appclaw/core @appclaw/core the SDK / headless engine

Local development

git clone https://github.com/appclawhq/AppClaw.git
cd AppClaw
npm install
npm run build
cp .env.example .env   # add your LLM key

See CLAUDE.md for the architecture overview, and appclaw.in for usage.

License

Licensed under the Apache License, Version 2.0. See LICENSE for the full text.

About

AI-powered mobile automation agent — describe what you want in plain English, AppClaw reads the screen, reasons, and acts. LLM-agnostic, open-source, zero telemetry.

Topics

Resources

License

Stars

94 stars

Watchers

4 watching

Forks

Contributors