by CodePhiliaX
๐ฆ Your AI Personal Assistant. An intelligent assistant with memory, skills, and scheduled tasks that truly understands you . Helping you tackle everything in work and life.
# Add to your Claude Code skills
git clone https://github.com/CodePhiliaX/youclawLast scanned: 5/8/2026
{
"issues": [
{
"type": "npm-audit",
"message": "@larksuiteoapi/node-sdk: Vulnerability found",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "axios: Axios has a NO_PROXY Hostname Normalization Bypass that Leads to SSRF",
"severity": "high"
},
{
"type": "npm-audit",
"message": "xlsx: Prototype Pollution in sheetJS",
"severity": "high"
}
],
"status": "WARNING",
"scannedAt": "2026-05-08T05:58:37.632Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}youclaw is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by CodePhiliaX. ๐ฆ Your AI Personal Assistant. An intelligent assistant with memory, skills, and scheduled tasks that truly understands you . Helping you tackle everything in work and life. It has 714 GitHub stars.
youclaw returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
Clone the repository with "git clone https://github.com/CodePhiliaX/youclaw" and add it to your Claude Code skills directory (see the Installation section above).
youclaw is primarily written in TypeScript. It is open-source under CodePhiliaX on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh youclaw against similar tools.
No comments yet. Be the first to share your thoughts!
Requires a passing catalog security scan. Resolve the flagged issues and resubmit to enable featuring.
Download the .dmg file from the Releases page, open it and drag YouClaw into Applications.
Apple Silicon (M1/M2/M3/M4) and Intel are both supported.
Download the .exe installer from Releases and run it.
๐ง Coming soon โ stay tuned!
YouClaw supports three browser profile drivers:
Managed Chromium โ recommended for most usersRemote CDP โ for existing advanced automation setupsExtension Relay โ advanced local attach mode for a browser that already exposes a loopback CDP endpointDetailed guide:
| Layer | Choice |
|---|---|
| Runtime & Package Manager | Bun |
| Desktop Shell | Tauri 2 (Rust) |
| Backend | Hono + bun:sqlite + Pino |
| Agent | @mariozechner/pi-coding-agent + @mariozechner/pi-ai |
| Frontend | Vite + React + shadcn/ui + Tailwind CSS |
| Channels | grammY (Telegram) ยท dingtalk-stream (DingTalk) ยท @larksuiteoapi/node-sdk (Feishu) ยท QQ ยท WeCom |
| Scheduled Tasks | croner |
| E2E Testing | Playwright |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Tauri 2 (Rust Shell) โ
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ WebView โ โ Bun Sidecar โ โ
โ โ Vite+React โโโโโบ Hono API Server โ โ
โ โ shadcn/ui โ HTTPโ Multi-provider Agent RT โ โ
โ โ โ SSE โ bun:sqlite โ โ
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
Tauri Store EventBus
(settings) โโโโโโโโโโดโโโโโโโโโโโโโ
โ โ
Web / API Multi-Channel
โโโโโโโโโผโโโโโโโโ
Telegram DingTalk Feishu
QQ WeCom
โ
Browser Automation
(Playwright)
git clone https://github.com/CodePhiliaX/youClaw.git
cd youClaw
# Install dependencies
bun install
cd web && bun install && cd ..
# Configure environment
cp .env.example .env
# Edit .env and set MODEL_API_KEY
# Terminal 1 โ backend
bun dev
# Terminal 2 โ frontend
bun dev:web
Open http://localhost:5173 ยท API at http://localhost:62601
bun dev:tauri
bun build:tauri
Output: src-tauri/target/release/bundle/ (DMG / MSI / AppImage)
bun dev # Backend dev server (hot reload)
bun dev:web # Frontend dev server
bun dev:tauri # Tauri dev mode (frontend + backend + WebView)
bun start # Production backend
bun typecheck # TypeScript type check
bun test # Run tests
bun build:sidecar # Compile Bun sidecar binary
bun build:tauri # Build Tauri desktop app
bun build:tauri:fast # Build without bundling (faster dev builds)
bun test:e2e # Run E2E tests (Playwright)
bun test:e2e:ui # Run E2E tests with UI
| Variable | Required | Default | Description |
|---|---|---|---|
MODEL_PROVIDER |
No | builtin |
Default model provider or runtime mode |
MODEL_ID |
No | minimax/MiniMax-M2.7-highspeed |
Default model reference |
MODEL_API_KEY |
Yes | โ | Model API key |
MODEL_BASE_URL |
No | โ | Custom model API base URL |
PORT |
No | 62601 |
Backend server port |
DATA_DIR |
No | ./data in dev, ~/.youclaw in desktop production |
Data storage directory. For dev, set DATA_DIR=~/.youclaw-dev if you want an isolated user-home data dir |
LOG_LEVEL |
No | info |
Log level |
TELEGRAM_BOT_TOKEN |
No | โ | Enable Telegram channel |
DINGTALK_CLIENT_ID |
No | โ | DingTalk app client ID |
DINGTALK_SECRET |
No | โ | DingTalk app secret |
FEISHU_APP_ID |
No | โ | Feishu (Lark) app ID |
FEISHU_APP_SECRET |
No | โ | Feishu (Lark) app secret |
QQ_BOT_APP_ID |
No | โ | QQ bot app ID |
QQ_BOT_SECRET |
No | โ | QQ bot secret |
WECOM_CORP_ID |
No | โ | WeCom corp ID |
WECOM_CORP_SECRET |
No | โ | WeCom corp secret |
WECOM_AGENT_ID |
No | โ | WeCom agent ID |
WECOM_TOKEN |
No | โ | WeCom callback token |
WECOM_ENCODING_AES_KEY |
No | โ | WeCom callback AES key |
YOUCLAW_WEBSITE_URL |
No | โ | Cloud service website URL |
YOUCLAW_API_URL |
No | โ | Cloud service API URL |
MINIMAX_API_KEY |
No | โ | MiniMax web search API key |
MINIMAX_API_HOST |
No | โ | MiniMax API host |
src/
โโโ agent/ # AgentManager, AgentRuntime, AgentQueue, PromptBuilder
โโโ channel/ # Multi-channel support
โ โโโ router.ts # MessageRouter
โ โโโ telegram.ts # Telegram (grammY)
โ โโโ dingtalk.ts # DingTalk (dingtalk-stream)
โ โโโ feishu.ts # Feishu / Lark (@larksuiteoapi/node-sdk)
โ โโโ qq.ts # QQ
โ โโโ wecom.ts # WeCom
โโโ config/ # Environment validation, path constants
โโโ db/ # bun:sqlite init, CRUD operations
โโโ events/ # EventBus (stream/tool_use/complete/error)
โโโ ipc/ # File-polling IPC between Agent and main process
โโโ logger/ # Pino logger
โโโ memory/ # Memory helpers for root MEMORY.md plus per-agent logs/archives
โโโ routes/ # Hono API routes (/api/*)
โโโ scheduler/ # Cron/interval/once task scheduler
โโโ skills/ # Skills loader, watcher, frontmatter parser
src-tauri/
โโโ src/ # Rust main process (sidecar, window, tray, updater)
agents/ # Agent workspaces (agent.yaml + bootstrap docs + MEMORY.md + skills/)
skills/ # Project-level skills (SKILL.md format)
e2e/ # E2E tests (Playwright)
web/src/
โโโ pages/ # Chat, Agents, Skills, Memory, Tasks, Channels, BrowserProfiles, Logs, System, Login
โโโ components/ # Layout + shadcn/ui
โโโ api/ # HTTP client + transport
โโโ i18n/ # i18n (Chinese / English)