opendraft-cli 0.1.0

Command-line interface for OpenDraft screenwriting platform

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

Group	Commands
projects	list create get update delete
scripts	list create get update duplicate delete
versions	list checkin diff restore
export	fountain pdf fdx
collab	invite sessions revoke revoke-all
templates	list create get update delete set-element

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

Env Var	Default	Description
OPENDRAFT_URL	http://localhost:8000	Backend base URL

AI Agent Integration

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

License

MIT