How do I install the Bananatape skill?

Run npx skillmds@latest add nomadamas/bananatape in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bananatape safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bananatape?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bananatape free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bananatape?

nomadamas (@nomadamas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bananatape by nomadamas — Agent Skill

Name: Bananatape
Rating: 4.2 (5 reviews)
Author: nomadamas

File contents

BananaTape

BananaTape is a local-first browser editor for AI image generation and editing. Use this skill when an agent needs to run BananaTape for a user, create a project, launch the editor, or perform a smoke test.

Requirements

Node.js 22+
BananaTape CLI: npm install -g bananatape or npx bananatape ...
A provider setup:
- OpenAI: OPENAI_API_KEY in the environment
- codex: Codex CLI already signed in with ~/.codex/auth.json
Optional project location override: BANANATAPE_PROJECTS_DIR=/path/to/projects

Do not print, commit, or ask the user to paste secret API keys into files. Do not edit ~/.codex/auth.json; ask the user to sign in with Codex CLI if it is missing.

CLI

bananatape create <name> [--dir <parent>]
bananatape list
bananatape launch <project> [--port <port>] [--no-open] [--rebuild]
bananatape open <project>
bananatape status [project]
bananatape stop <project|--all>
bananatape delete <project> [--delete-files]

Notes:

launch and open are aliases.
Projects are local folders; by default they live under ~/Documents/BananaTape Projects/.
Multiple projects can run at once on different ports.
Use --no-open for agent smoke tests or headless checks.
delete unregisters a project by default; --delete-files also removes the project folder.

Basic agent usage

# Install if needed
npm install -g bananatape

# Optional deterministic test location
export BANANATAPE_PROJECTS_DIR="$PWD/.bananatape-projects"

# Configure one provider before launch
export OPENAI_API_KEY="<user-provided-key>"
# or verify Codex auth exists:
# test -f "$HOME/.codex/auth.json"

bananatape create "Agent Smoke Test"
bananatape launch agent-smoke-test --no-open --port 45991
bananatape status agent-smoke-test

# Optional readiness check
curl --fail --silent --show-error http://127.0.0.1:45991/api/projects/current

# Clean up when done
bananatape stop agent-smoke-test

For normal user-facing use, omit --no-open so BananaTape opens in the user's browser.

---name: bananatapedescription: Use BananaTape CLI to create, launch, inspect, and clean up local AI image editing projects from an agent.---# BananaTapeBananaTape is a local-first browser editor for AI image generation and editing. Use this skill when an agent needs to run BananaTape for a user, create a project, launch the editor, or perform a smoke test.## Requirements- Node.js 22+- BananaTape CLI: `npm install -g bananatape` or `npx bananatape ...`- A provider setup: - OpenAI: `OPENAI_API_KEY` in the environment - codex: Codex CLI already signed in with `~/.codex/auth.json`- Optional project location override: `BANANATAPE_PROJECTS_DIR=/path/to/projects`Do not print, commit, or ask the user to paste secret API keys into files. Do not edit `~/.codex/auth.json`; ask the user to sign in with Codex CLI if it is missing.## CLI```bashbananatape create <name> [--dir <parent>]bananatape listbananatape launch <project> [--port <port>] [--no-open] [--rebuild]bananatape open <project>bananatape status [project]bananatape stop <project|--all>bananatape delete <project> [--delete-files]```Notes:- `launch` and `open` are aliases.- Projects are local folders; by default they live under `~/Documents/BananaTape Projects/`.- Multiple projects can run at once on different ports.- Use `--no-open` for agent smoke tests or headless checks.- `delete` unregisters a project by default; `--delete-files` also removes the project folder.## Basic agent usage```bash# Install if needednpm install -g bananatape# Optional deterministic test locationexport BANANATAPE_PROJECTS_DIR="$PWD/.bananatape-projects"# Configure one provider before launchexport OPENAI_API_KEY="<user-provided-key>"# or verify Codex auth exists:# test -f "$HOME/.codex/auth.json"bananatape create "Agent Smoke Test"bananatape launch agent-smoke-test --no-open --port 45991bananatape status agent-smoke-test# Optional readiness checkcurl --fail --silent --show-error http://127.0.0.1:45991/api/projects/current# Clean up when donebananatape stop agent-smoke-test```For normal user-facing use, omit `--no-open` so BananaTape opens in the user's browser.

Frequently asked questions

Bananatape