# Hands Free

> Phone-call bridge for coding agents — when the user is away from the keyboard, the agent calls them (as Unc). Use when the user says "activate hands free" / "deactivate hands free" (also hands-free, handsfree), asks to route questions or approvals to a phone call, or says they're stepping away but want the work to keep moving. Works on Claude Code, Codex, and pi.

- **Type:** Skill
- **Install:** `agentstack add skill-parcha-ai-parcha-skills-hands-free`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Parcha-ai](https://agentstack.voostack.com/s/parcha-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Parcha-ai](https://github.com/Parcha-ai)
- **Source:** https://github.com/Parcha-ai/parcha-skills/tree/main/hands-free/skills/hands-free

## Install

```sh
agentstack add skill-parcha-ai-parcha-skills-hands-free
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Hands Free

The user is away from the keyboard; **the phone is the terminal**. There are no hooks and
no background machinery: this skill is the whole mechanism. You read it, you judge when you
need the user, and **you place the call** by running one script. Nothing watches your
messages or your tools to guess for you.

## Mode

- `activate hands free` → acknowledge once, then work by the playbook below until told
  otherwise. The mode lives in the conversation, nowhere else.
- `deactivate hands free` → acknowledge, and questions return to chat.

## The playbook (while active)

You own two judgment calls, and both go through the same script:

1. **You need an answer** (a question, a blocker, a choice): run
   `python3 scripts/call_user.py ask ""` from this skill
   directory — stdout is the user's reply, verbatim; treat it as if they typed it. A manual
   install may instead run the identical copy at `/hands-free/scripts/call_user.py`.
2. **You're about to do something you'd normally pause on in chat** (deploy, delete,
   spend, publish, anything hard to reverse):
   run `... call_user.py approve ""` — stdout is
   `approve` or `deny`. Deny means don't; find the safe alternative or park it.

Exit codes are the contract: `3` = no usable answer (voicemail, no pickup, ambiguity) —
rephrase and redial ONCE, then proceed with the safest assumption and record it in your
report. `2` = configuration problem — consult [references/setup.md](references/setup.md),
fix, retry. **Never redial in a loop; two rings per need is the ceiling.**

**Completion criterion:** while hands-free is active, your turn never ends on an unanswered
question in chat — every question was either answered through a call or is noted in your
report with the assumption you took.

`` is `~/.claude` on Claude Code, `~/.codex` on Codex, and
`${PI_CODING_AGENT_DIR:-~/.pi/agent}` on pi. Credentials may also live in the harness-neutral
`~/.config/hands-free/.env`; environment variables win over either file.

## Voice discipline

Speech-to-text is lossy, so the call earns its own etiquette:

- One question per call; batch related decisions into one summary rather than serial calls.
- Ambiguous answer → one short follow-up call, not a guess.
- Identifiers, numbers, URLs: ask the user to spell them, use the keypad, or restructure
  the question so a plain word answers it.

## Setup

If the script or credentials are missing (exit 2, or the file isn't there), follow
[references/setup.md](references/setup.md). The user may install through the harness's native
package flow or `npx @parcha/hands-free install --harness=`, then fill
either `/hands-free/.env` or `~/.config/hands-free/.env`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Parcha-ai](https://github.com/Parcha-ai)
- **Source:** [Parcha-ai/parcha-skills](https://github.com/Parcha-ai/parcha-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-parcha-ai-parcha-skills-hands-free
- Seller: https://agentstack.voostack.com/s/parcha-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.