seereelcli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,64 @@
1
+ # reelyai
2
+
3
+ Local agent CLI for creating and driving SeeReel web workflows.
4
+
5
+ The default target is `https://seereel.studio`, and you can point it at a local
6
+ server with `SEEREEL_AGENT_BASE_URL` or `--base-url`.
7
+
8
+ ```bash
9
+ npm install -g ./packages/reelyai-cli
10
+ seereelcli workflow "一个失眠导演在午夜便利店遇见未来的自己" --duration 60
11
+ ```
12
+
13
+ From npm:
14
+
15
+ ```bash
16
+ npm install -g seereelcli
17
+ seereelcli skill install --agent all
18
+ ```
19
+
20
+ The package bundles the `reelyai-cli` skill. `seereelcli skill install --agent all`
21
+ copies it into local Codex, Claude, Cursor, and generic `.agents` skill folders.
22
+
23
+ For deployments protected by `SEEREEL_ACCESS_TOKEN`:
24
+
25
+ ```bash
26
+ seereelcli configure --base-url https://seereel.studio --access-token "$SEEREEL_ACCESS_TOKEN"
27
+ ```
28
+
29
+ For browser-scoped Agent Plan generation:
30
+
31
+ ```bash
32
+ seereelcli configure --agent-plan-token "$ARK_AGENT_PLAN_KEY"
33
+ ```
34
+
35
+ Main commands:
36
+
37
+ - `seereelcli workflow "<idea>"`: create a session, generate script, and generate storyboard/workflow.
38
+ - `seereelcli status --session latest --deep --json`: inspect shots, renders, errors, stitch state, and download URL.
39
+ - `seereelcli render --session latest --stitch --progress`: generate missing shots and stitch the final video with visible progress.
40
+ - `seereelcli render --session latest --stitch --stitch-partial --repair-policy safe-retry --max-attempts 2`: retry policy failures with a safer prompt and stitch ready shots.
41
+ - `seereelcli download --session latest --output ./final.mp4`: save the final video locally without custom fetch scripts.
42
+ - `seereelcli handoff --session latest --open`: create a one-time handoff link so a normal browser can claim and edit a CLI-owned session.
43
+ - `seereelcli open --session latest`: open the session URL (`#/s/<sessionId>`).
44
+
45
+ Recommended agent flow:
46
+
47
+ ```bash
48
+ seereelcli workflow "<idea>" --duration 60 --json
49
+ seereelcli status --session latest --deep --json
50
+ seereelcli render --session latest --stitch --progress --json
51
+ ```
52
+
53
+ `workflow --json` includes both `webUrl` and `handoffUrl`. Because CLI and
54
+ browser identities are isolated by `seereel_user_id` cookies, return `handoffUrl`
55
+ when a human needs to see and continue editing the AI-created workflow in a
56
+ normal browser. The raw `webUrl` is still useful inside the CLI cookie scope.
57
+
58
+ Use `--jsonl` for long fully automated runs; it emits `session_created`,
59
+ `shot_submitted`, `task_id`, `poll_status`, `retrying`, and `stitch_ready`
60
+ events as newline-delimited JSON.
61
+
62
+ The CLI stores only local configuration and cookies under `~/.seereel/config.json`.
63
+ The SeeReel app remains the source of truth for sessions, shots, prompts, renders,
64
+ stitch jobs, and final videos.