banana-cli
CLI tool for creating, managing, and exporting AI-generated presentations via the Banana Slides API. Use when the user asks to: (1) generate a PPT/presentation/slides from an idea, outline, or description, (2) export a project to PPTX, PDF, or images, (3) batch-generate multiple presentations, (4) manage projects, pages, materials, or templates programmatically, (5) renovate/redesign an existing PPT or PDF, (6) edit slide images with natural language.
How do I install this agent skill?
npx skills add https://github.com/anionex/banana-slides --skill banana-cliIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The banana-cli skill provides an interface for managing AI-generated presentations through a dedicated CLI tool. The setup process involves cloning the project's source code from the author's GitHub repository and configuring AI provider API keys in a local environment file. The tool operates as a standard developer utility with no detected malicious patterns.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
banana-cli
CLI for creating, managing, and exporting AI-generated presentations.
Environment Check
Before running any command, verify the backend is reachable:
curl -sf http://localhost:5011/health
If this fails, the backend is not running. Read references/setup.md and follow the steps to clone the repo, configure .env, and start the backend. Do not proceed until the health check passes.
Invocation
banana-cli <command> [options]
If banana-cli is not on PATH, use uv run banana-cli from the project root, or install globally with uv tool install .
End-to-End Workflow
# 1. Create project and set as working project
result=$(banana-cli --json projects create --creation-type idea --idea-prompt "Your topic")
project_id=$(echo "$result" | jq -r '.data.project_id')
banana-cli projects use "$project_id"
# 2. Generate everything (outline → descriptions → images)
banana-cli workflows full --language zh --pages 8
# 3. Export to local file
banana-cli exports pptx --output ./slides.pptx
Once a working project is set, --project-id is optional on all subsequent commands.
Key Patterns
Short ID prefix matching
All --project-id and --page-id accept short prefixes (like git short hashes):
banana-cli projects get a1b2 # matches a1b2c3d4-...
banana-cli pages edit-image --page-id b9c8 --instruction "change title to red"
Working project context
Avoid repeating --project-id by setting a working project:
banana-cli projects use a1b2 # set (accepts prefix)
banana-cli workflows outline # uses working project
banana-cli projects use # show current
banana-cli projects unuse # clear
Page count control
--pages is a hint to the AI — actual page count may differ. The CLI warns on stderr when they don't match.
banana-cli workflows outline --pages 5
banana-cli workflows full --pages 10 --language en
Export with auto-download
# Download directly to local path
banana-cli exports pptx --output ./slides.pptx
banana-cli exports pdf --output ./report.pdf
# Without --output, returns a server-side download URL
banana-cli exports pptx
Batch generation
cat > jobs.jsonl << 'EOF'
{"job_id":"t1","job_type":"full_generation","creation_type":"idea","idea_prompt":"AI Intro","language":"zh","export":{"formats":["pptx"]}}
{"job_id":"t2","job_type":"full_generation","creation_type":"idea","idea_prompt":"ML Basics","language":"zh","export":{"formats":["pptx","pdf"]}}
EOF
banana-cli run jobs --file jobs.jsonl --report report.json --state-file state.json
Renovate existing PPT
banana-cli renovation create --file /absolute/path/to/slides.pptx --language zh
JSON output for scripting
banana-cli --json projects list | jq '.data.projects[].project_id'
Important Notes
- File path arguments (
--file,--image) require absolute paths - Async tasks (descriptions, images, editable export) wait by default and show progress on stderr. Pass
--no-waitto get a task_id immediately --wait/tasks waitcan be interrupted (Ctrl+C) and resumed anytime — backend tasks are unaffected- Progress lines go to stderr (format:
[PROGRESS] STAGE STATUS completed/total), keeping stdout JSON clean --helpoutput is plain text when piped (non-TTY) — safe for agent consumption- Config priority: CLI args > env vars (
BANANA_CLI_*) > TOML config (~/.config/banana-slides/cli.toml) > defaults
Discovering Commands
Run banana-cli --help for the top-level command list, and banana-cli <command> --help for subcommand options. Help output is plain text when piped (non-TTY).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/anionex/banana-slides/banana-cli">View banana-cli on skillZs</a>