@xyril/arkctl-linux-x64 0.1.3
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/bin/arkctl +0 -0
- package/package.json +20 -0
- package/skills/arkctl-cli/SKILL.md +67 -0
package/bin/arkctl
ADDED
|
Binary file
|
package/package.json
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@xyril/arkctl-linux-x64",
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "arkctl binary for Linux x64",
|
|
5
|
+
"os": [
|
|
6
|
+
"linux"
|
|
7
|
+
],
|
|
8
|
+
"cpu": [
|
|
9
|
+
"x64"
|
|
10
|
+
],
|
|
11
|
+
"files": [
|
|
12
|
+
"bin/arkctl",
|
|
13
|
+
"skills"
|
|
14
|
+
],
|
|
15
|
+
"repository": {
|
|
16
|
+
"type": "git",
|
|
17
|
+
"url": "https://github.com/Xyri1/arkctl"
|
|
18
|
+
},
|
|
19
|
+
"license": "MIT"
|
|
20
|
+
}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: arkctl-cli
|
|
3
|
+
description: Use when an agent needs to operate the repo-owned `arkctl` CLI for Volcengine Ark video workflows, including generating videos, checking task status, listing tasks, canceling tasks, or installing the bundled repo skills. Use when the user wants exact `arkctl` commands or CLI execution, but never to handle API-key entry or interactive auth on the user's behalf.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# arkctl CLI
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
|
|
10
|
+
Use `arkctl` for Ark video-task workflows and for installing the repo-owned skill bundle. Treat authentication as human-only setup.
|
|
11
|
+
|
|
12
|
+
## Hard Rules
|
|
13
|
+
|
|
14
|
+
- Never run `arkctl auth set`.
|
|
15
|
+
- Never ask the user to paste an API key into chat.
|
|
16
|
+
- Never store, echo, transform, or relay an Ark API key.
|
|
17
|
+
- If auth is missing or broken, tell the user to run the auth command themselves.
|
|
18
|
+
|
|
19
|
+
## Human-Only Setup
|
|
20
|
+
|
|
21
|
+
If credentials are not configured, give the user these commands and stop short of performing auth yourself:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
arkctl auth set
|
|
25
|
+
arkctl auth status
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Use `arkctl auth status` to confirm whether credentials are ready after the user completes setup.
|
|
29
|
+
|
|
30
|
+
## Agent-Safe Commands
|
|
31
|
+
|
|
32
|
+
Generate a video:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
arkctl video generate \
|
|
36
|
+
--prompt "A corgi walking through a sunny park" \
|
|
37
|
+
--model doubao-seedance-2-0-260128 \
|
|
38
|
+
--duration 5 \
|
|
39
|
+
--resolution 1280x720
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Inspect or manage tasks:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
arkctl video get <task_id>
|
|
46
|
+
arkctl video list
|
|
47
|
+
arkctl video cancel <task_id>
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Install the bundled repo skill:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
arkctl skills install
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Output Expectations
|
|
57
|
+
|
|
58
|
+
- Read `stdout` as raw Ark API JSON.
|
|
59
|
+
- Read `stderr` for polling progress and error text.
|
|
60
|
+
- On successful generation, expect the video URL under `content.video_url`.
|
|
61
|
+
- Exit codes: `0` success, `1` API or input error, `2` timeout, `3` auth error.
|
|
62
|
+
|
|
63
|
+
## Security Notes
|
|
64
|
+
|
|
65
|
+
- `arkctl` reduces simple plaintext exposure by avoiding API keys in args, env vars, and config files.
|
|
66
|
+
- This is only a lightweight barrier against simple prompt injection and accidental leakage.
|
|
67
|
+
- It does not protect against a compromised machine or malicious same-user local code.
|