opendraft-cli

Command-line interface for OpenDraft — the open-source screenwriting platform.

Manage projects, scripts, versions, exports, collaboration, and formatting templates directly from your terminal or AI agent (Claude Code / OpenClaw).

Installation

pip install opendraft-cli

Requirements

• Python 3.10+
• OpenDraft backend running (locally or remote)

Quick Start

# Point at your OpenDraft backend (default: http://localhost:8000)
export OPENDRAFT_URL=http://localhost:8000

# List projects
opendraft --json projects list

# Create a project
opendraft --json projects create --name "My Screenplay"

# Create a script inside that project
opendraft --json scripts create <project-id> --title "Act One"

# Check in a version
opendraft --json versions checkin <project-id> --message "First draft"

# Export to Fountain
opendraft --json export fountain <script-id>

Note: --json is a root-level flag and must come before the subcommand. opendraft --json projects list ✓
opendraft projects list --json ✗

Command Reference

Run opendraft --help or opendraft <group> --help for full options.

Output Format

All commands support --json for machine-readable output:

{"ok": true, "data": {...}}
{"ok": false, "error": "Not found", "code": 404}

Human-readable output (default) uses rich tables and colored text.

Configuration

AI Agent Integration

See SKILL.md for Claude Code / OpenClaw integration instructions.

License

MIT