Skip to content
TakoAPI
Back to skills

record

by atacan

Web & Frontend Development
1.2kDownloads reported by clawskills.sh
5Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

macOS CLI tool for recording audio (microphone), screen (video/screenshot), and camera (video/photo)

Description

What This Skill Does

record is a macOS CLI tool for capturing audio from the microphone, video or screenshots from the screen, and video or photos from the camera. Output file paths print to stdout and status messages to stderr, making it usable in shell pipelines and AI agent workflows. Supports JSON output and a duration flag for non-interactive use.

The stdout/stderr separation and --duration flag let scripts and AI agents capture media without manual interaction or GUI tools.

When to Use It

  • Recording a voice memo from the terminal without opening an app
  • Taking a screenshot of a specific window by name from a script
  • Capturing webcam footage during a timed session
  • Recording screen with microphone audio for a bug report
  • Automating media capture steps inside an AI agent pipeline

Example Workflow

INPUT

User asks: Record 10 seconds of audio and save it to /tmp/meeting.m4a

AGENT
  1. 1

    Confirm with the user that microphone audio will be captured for 10 seconds

  2. 2

    Run: record audio --duration 10 --output /tmp/meeting.m4a

  3. 3

    Read the output file path from stdout

  4. 4

    Report the saved path back to the user

OUTPUT

Audio saved to /tmp/meeting.m4a

Requirements

  • Install the CLI: brew install atacan/tap/record
  • Grant Microphone permission to your terminal app in macOS System Settings > Privacy & Security
  • Grant Screen Recording permission to your terminal app for screen capture
  • Grant Camera permission to your terminal app for webcam recording

Installation

clawhub install atacan/record

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links