Skip to content

Latest commit

 

History

History

README.md

Claude Code Wingman 🦅

Run Claude Code as a Clawdbot skill. Control it from WhatsApp, track progress, and approve actions - all without leaving your chat.

What It Does

Clawdbot spawns Claude Code in a tmux session. When Claude Code needs permission to do something, you get notified via WhatsApp (or Clawdbot dashboard) and can approve or deny.

  • Give tasks via chat: "Fix the bug in api.py"
  • Get approval requests: "Claude Code wants to edit 3 files. Allow?"
  • Track progress: Ask "what's the status?" anytime
  • Take over: Attach to the tmux session to see or control Claude Code directly

Install

Via ClawdHub (recommended)

clawdhub install claude-code-wingman

Then restart Clawdbot to pick up the new skill.

You can also enable it from the Clawdbot Dashboard under Skills.

Manual Install

git clone https://github.com/yossiovadia/claude-code-wingman.git
cd claude-code-wingman
chmod +x *.sh

Requirements: tmux, Claude Code CLI (claude), bash

Usage

Once installed, just ask Clawdbot to do coding tasks. It will spawn Claude Code and keep you in the loop.

Example: "Hey, fix the auth bug in api.py"

Clawdbot will:

  1. Spawn Claude Code in a tmux session
  2. Forward the task
  3. Notify you when Claude Code needs approval
  4. Report back when done

Attach to Session

Want to see what Claude Code is doing? Attach to the tmux session:

tmux attach -t <session-name>

Detach with Ctrl+B then D. The session keeps running.

Auto Mode

For trusted environments, skip the approval prompts with --auto flag.

Commands

Command Description
tmux attach -t <session> Watch/control Claude Code live
tmux capture-pane -t <session> -p Get current output
tmux kill-session -t <session> Stop a session

Links