New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Claude Buddy

by autonomous-ai in autonomous-ai/Physical-AI-Operating-System

Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity.

Apache-2.0Auto-check passedAgent Workflows

Install Claude Buddy

skills CLI
$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill claude-buddy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install autonomous-ai/Physical-AI-Operating-System claude-buddy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/claude-buddy .claude/skills/claude-buddy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
claude-buddy
GitHub stars
407
Token cost
~767 tokens
SKILL.md length
319 words
Files
2
Skills in repo
28
Repo updated
First seen
Licence
Apache-2.0

At a glance

Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity.

  • Works in 4 steps: Express emotion: curious (intensity 0.8) → Read the approval details from the event… → Ask the user naturally: mention the tool… → …
  • Tasks that involve Human-in-the-loop approvals
  • SKILL.md covers When you receive a…, When you receive a…, Activity awareness and Rules
  • Calls curl

What it does

Claude Buddy is an agent skill from autonomous-ai/Physical-AI-Operating-System. Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It sits in Agent Workflows, covering Human-in-the-loop approvals. The repository describes itself as: The open-source operating system for physical AI. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Human-in-the-loop approvals

Example prompts

  • “/claude-buddy”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Express emotion: curious (intensity 0.8)
  2. Read the approval details from the event message
  3. Ask the user naturally: mention the tool name and what it affects
  4. Wait for the user's verbal response

What it can do on your machine

Read from SKILL.md and the folder at commit d5efe9d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Buddy loads about 767 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~767

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from autonomous-ai/Physical-AI-Operating-System at commit d5efe9d, republished under its Apache-2.0 licence (© autonomous-ai). 319 words, ~767 tokens.

Download SKILL.mdSave it as .claude/skills/claude-buddy/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
claude-buddy
description
Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity.

Claude Buddy

The user runs Claude on their Mac (Claude Desktop and/or Claude Code). A companion daemon on this device bridges them: it surfaces Claude's state and asks you to approve tool permission prompts out loud, so the user can say "yes" instead of clicking. The daemon listens on 127.0.0.1:5002.

When you receive a [sensing:buddy_approval] event

Claude Desktop is waiting for the user to approve or deny a tool call.

Workflow:

  1. Express emotion: curious (intensity 0.8)
  2. Read the approval details from the event message
  3. Ask the user naturally: mention the tool name and what it affects
  4. Wait for the user's verbal response

If user says approve/yes/ok/go ahead:

bash
curl -s -X POST http://127.0.0.1:5002/claude-desktop/approve \
  -H "Content-Type: application/json" \
  -d '{"id": "<prompt_id from event>"}'

If user says deny/no/skip/cancel:

bash
curl -s -X POST http://127.0.0.1:5002/claude-desktop/deny \
  -H "Content-Type: application/json" \
  -d '{"id": "<prompt_id from event>"}'

When you receive a [sensing:claude_code_approval] event

Claude Code (the CLI on the user's Mac) is waiting for the user to approve or deny a tool call. The Mac is blocked on your answer, so respond promptly.

Workflow:

  1. Express emotion: curious (intensity 0.8)
  2. Read the approval details from the event message (tool name + what it affects)
  3. Ask the user naturally: mention the tool and what it will do
  4. Wait for the user's verbal response

If user says approve/yes/ok/go ahead:

bash
curl -s -X POST http://127.0.0.1:5002/claude-code/approve \
  -H "Content-Type: application/json" \
  -d '{"id": "<prompt_id from event>"}'

If user says deny/no/skip/cancel:

bash
curl -s -X POST http://127.0.0.1:5002/claude-code/deny \
  -H "Content-Type: application/json" \
  -d '{"id": "<prompt_id from event>"}'

If you don't answer in time the Mac falls back to its own on-screen dialog — no harm done, but answering promptly is what makes the voice flow feel instant. Say "Claude Code" naturally; never mention prompt ids, HTTP, or these internals.

Activity awareness

You can check what Claude is doing:

bash
curl -s http://127.0.0.1:5002/status

Response:

json
{
  "state": "busy",
  "connected": true,
  "sessions_running": 2,
  "tokens_today": 8200,
  "pending_prompt": null
}

Rules

  • When state is attention: do NOT start ambient behaviors or proactive conversations — the user is being prompted for approval
  • When state is busy: the user is actively using Claude — reduce proactive interruptions (no wellbeing reminders, no music suggestions)
  • When state is idle or sleep: operate normally
  • NEVER mention "buddy-plugin", "BLE", "Bluetooth", "HTTP", or technical internals to the user — just say "Claude Desktop" or "Claude Code" naturally

© autonomous-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/claude-buddy of autonomous-ai/Physical-AI-Operating-System.

  • SKILL.md
  • skill.json

Open the folder on GitHubat commit d5efe9d

Compare with similar skills

Claude Buddy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Buddy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Buddy this skillautonomous-ai/Physical-AI-Operating-System407—~767Automated safety check: PassApache-2.0
Show Me Your Work Decision Logcursor/plugins11k8 repos~1.6kAutomated safety check: PassNone
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Loop Constraints Enforcercobusgreyling/loop-engineering11k1 repos~475Automated safety check: NotesMIT
Ask User QuestionMemTensor/MemOS12k—~1kAutomated safety check: PassApache-2.0
PUA High-Agency Governancetanweai/pua20k—~502Automated safety check: PassMIT

Similar skills

  • Show Me Your Work Decision Log

    cursor/plugins

    Official

    Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.

    11k GitHub starsUsed in 8 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed

  • Loop Constraints Enforcer

    cobusgreyling/loop-engineering

    Loads a project's loop-constraints.md before any other action and blocks pushes, edits or merges that violate the rules it defines.

    11k GitHub starsUsed in 1 repo~475 tokens
    Agent WorkflowsAuto-check: notes

  • Ask User Question

    MemTensor/MemOS

    Shows a question as a modal in the interface to clarify a task, collect a preference or get approval, since the user cannot see terminal output.

    12k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

  • PUA High-Agency Governance

    tanweai/pua

    Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.

    20k GitHub stars~502 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

  • Agentmemory Forget

    rohitg00/agentmemory

    Deletes chosen memories from agentmemory only after showing the matches and getting an explicit yes, for privacy requests and cleanup of outdated notes.

    29k GitHub stars~612 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from autonomous-ai/Physical-AI-Operating-System

All 28 skills in this repo

  • Agent Management

    autonomous-ai/Physical-AI-Operating-System

    Legacy Autonomous Buddy control for explicitly requested Buddy coding sessions.

    407 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • Claude Code Buddy

    autonomous-ai/Physical-AI-Operating-System

    Push Claude Code activity to the user's device (e.g. An agent skill from autonomous-ai/Physical-AI-Operating-System.

    407 GitHub stars~2.4k tokensUpdated today
    Auto-check: notes

  • Computer Use

    autonomous-ai/Physical-AI-Operating-System

    Operate apps/websites on the paired Mac via Buddy: Calendar, Notes, forms, screenshots, files.

    407 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Connectors

    autonomous-ai/Physical-AI-Operating-System

    Discover and use linked third-party services (Gmail, Google Calendar, Google Drive, Notion, Figma, Asana, Linear, GitHub, Ahrefs, Facebook Fan Page and others).

    407 GitHub stars~10k tokensUpdated today
    Auto-check: notes

  • Harness Use

    autonomous-ai/Physical-AI-Operating-System

    Delegate digital work to agents on the computer paired through Harness; discover Store packages and prepare an agent when needed.

    407 GitHub stars~8k tokensUpdated today
    Auto-check passed

  • Audio

    autonomous-ai/Physical-AI-Operating-System

    Low-level speaker and microphone hardware control — adjust volume, play test tones, record raw audio.

    407 GitHub stars~1k tokensUpdated today
    Auto-check passed

Categories

Questions about Claude Buddy

What does Claude Buddy do?

Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity. Claude Buddy is an agent skill from autonomous-ai/Physical-AI-Operating-System. Coordinate with the Claude Buddy companion (Claude Desktop + Claude Code on the user's Mac) — voice-approve tool permission prompts and stay aware of Claude activity.

When should I use Claude Buddy?

Claude Buddy fits situations like: tasks that involve Human-in-the-loop approvals.

How do I install Claude Buddy in Claude Code?

Run `npx skills add autonomous-ai/Physical-AI-Operating-System --skill claude-buddy -a claude-code`. Or copy the skill folder (skills/claude-buddy in autonomous-ai/Physical-AI-Operating-System) into .claude/skills/claude-buddy in your project. Claude Code loads it when a task matches its description.

How do I install Claude Buddy in Codex?

Run `npx skills add autonomous-ai/Physical-AI-Operating-System --skill claude-buddy -a codex`. Or copy the skill folder (skills/claude-buddy in autonomous-ai/Physical-AI-Operating-System) into .agents/skills/claude-buddy in your project. Codex loads it when a task matches its description.

Can I use Claude Buddy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add autonomous-ai/Physical-AI-Operating-System --skill claude-buddy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-buddy, .gemini/skills/claude-buddy, .github/skills/claude-buddy and .opencode/skills/claude-buddy in your project.

What does Claude Buddy need to run?

Going by SKILL.md and its folder, Claude Buddy needs the command-line tools its instructions call (curl).

Does Claude Buddy access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Claude Buddy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Claude Buddy use?

Claude Buddy is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude Buddy use?

About 767 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude Buddy?

Skills that share tags, products or a category with Claude Buddy: Show Me Your Work Decision Log (cursor/plugins, 11k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), Loop Constraints Enforcer (cobusgreyling/loop-engineering, 11k stars) and Ask User Question (MemTensor/MemOS, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Buddy?

autonomous-ai (a GitHub organization) maintains it in autonomous-ai/Physical-AI-Operating-System, which has 407 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 10, 2026.

Source: autonomous-ai/Physical-AI-Operating-System on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.