@actiondock/cli 2.0.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 +85 -0
- package/bin/ac.js +4 -0
- package/dist/index.js +44620 -0
- package/package.json +51 -0
- package/src/commands/action.ts +602 -0
- package/src/commands/build.ts +54 -0
- package/src/commands/config.ts +398 -0
- package/src/commands/doctor.ts +64 -0
- package/src/commands/export.ts +70 -0
- package/src/commands/index.ts +43 -0
- package/src/commands/info.ts +539 -0
- package/src/commands/init.ts +24 -0
- package/src/commands/link.ts +74 -0
- package/src/commands/mcp.ts +199 -0
- package/src/commands/playbook.ts +359 -0
- package/src/commands/profile.ts +263 -0
- package/src/commands/runs.ts +319 -0
- package/src/commands/serve.ts +101 -0
- package/src/commands/state.ts +396 -0
- package/src/commands/test.ts +26 -0
- package/src/index.ts +20 -0
- package/src/utils/bytes.ts +36 -0
- package/src/utils/duration.ts +1 -0
- package/src/utils/filter.ts +24 -0
package/README.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# @actiondock/cli
|
|
2
|
+
|
|
3
|
+
The official Command Line Interface (CLI) toolchain for ActionDock 2.0.
|
|
4
|
+
|
|
5
|
+
[](https://bun.sh/)
|
|
6
|
+
[](https://www.typescriptlang.org/)
|
|
7
|
+
[](https://opensource.org/licenses/Apache-2.0)
|
|
8
|
+
|
|
9
|
+
> **Runtime requirement**: [Bun](https://bun.sh/) >= 1.2.0 is required.
|
|
10
|
+
> *(ActionDock CLI relies natively on Bun. Even if you install via `npm install -g @actiondock/cli`, Bun must be installed on your machine as the executable shebang runs via `#!/usr/bin/env bun`.)*
|
|
11
|
+
|
|
12
|
+
`@actiondock/cli` provides the `ac` command to develop, test, build, deploy, and export AI Agent Actions and Skills across MCP, HTTP, CLI, and standalone executables.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
# Global installation via Bun
|
|
20
|
+
bun add -g @actiondock/cli
|
|
21
|
+
|
|
22
|
+
# Or via npm
|
|
23
|
+
npm install -g @actiondock/cli
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Quick Start in 5 Steps
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
# 1. Initialize a new Action package scaffold
|
|
32
|
+
ac init my-tools
|
|
33
|
+
cd my-tools
|
|
34
|
+
|
|
35
|
+
# 2. Run an Action locally (outputs standard JSON envelope)
|
|
36
|
+
ac run sample.greet --input '{"name": "Alice"}'
|
|
37
|
+
|
|
38
|
+
# 3. Run in-memory unit tests
|
|
39
|
+
ac test
|
|
40
|
+
|
|
41
|
+
# 4. Compile into a single standalone binary
|
|
42
|
+
ac build
|
|
43
|
+
|
|
44
|
+
# 5. Export as a portable Agent Skill (with SOPs)
|
|
45
|
+
ac export skill
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## Command Cheat Sheet
|
|
51
|
+
|
|
52
|
+
| Command | Purpose |
|
|
53
|
+
|---|---|
|
|
54
|
+
| `ac init [dir]` | Initialize an Action package scaffold |
|
|
55
|
+
| `ac info [patterns...]` | Explore capabilities and display metadata (supports fuzzy matching and `--tree`) |
|
|
56
|
+
| `ac doctor` | Run environment, global registry health, and project diagnostics |
|
|
57
|
+
| `ac action list` / `ac run <id>` | List and execute Actions |
|
|
58
|
+
| `ac playbook list` / `show` | Inspect agent task SOP Playbooks |
|
|
59
|
+
| `ac config list` / `get` / `set` | Manage runtime configurations |
|
|
60
|
+
| `ac state list` / `get` / `set` / `delete` / `clear` | Inspect and manage persistent state (with namespaces, TTL, and clear) |
|
|
61
|
+
| `ac runs list` / `show` | Inspect execution history and traces |
|
|
62
|
+
| `ac test` | Run fast unit tests |
|
|
63
|
+
| `ac build` | Compile into a zero-dependency standalone binary |
|
|
64
|
+
| `ac export skill` | Export Skill bundle for AI Agent platforms |
|
|
65
|
+
| `ac link` / `unlink` | Manage global router (with live subproject auto-discovery and prune) |
|
|
66
|
+
| `ac profile` / `ac serve` | Manage remote node profiles and start HTTP Runner |
|
|
67
|
+
| `ac mcp` | Start ActionDock as STDIO or HTTP MCP server |
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 📖 Complete Documentation
|
|
72
|
+
|
|
73
|
+
For the full list of flags, options, remote profiles, and advanced usage, refer to the [ActionDock Documentation Center](https://github.com/team4u/actiondock#readme):
|
|
74
|
+
|
|
75
|
+
- [CLI Reference Manual](https://github.com/team4u/actiondock/blob/main/docs/reference/cli.md)
|
|
76
|
+
- [Quick Start Guide](https://github.com/team4u/actiondock/blob/main/docs/getting-started/quick-start.md)
|
|
77
|
+
- [MCP Integration Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/mcp.md)
|
|
78
|
+
- [Standalone Binary Build Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/standalone-build.md)
|
|
79
|
+
- [Skill Export Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/skill-export.md)
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## License
|
|
84
|
+
|
|
85
|
+
[Apache-2.0](LICENSE) © team4u
|
package/bin/ac.js
ADDED