# Bananatape

> Use BananaTape CLI to create, launch, inspect, and clean up local AI image editing projects from an agent.

- Skill: `nomadamas/bananatape` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nomadamas/bananatape`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nomadamas/bananatape/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: nomadamas (https://skillmd.com/u/nomadamas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nomadamas/bananatape

---


# 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

```bash
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

```bash
# 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.