schwarm-cli 0.1.2 → 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.
- checksums.yaml +4 -4
- data/README.md +68 -0
- data/lib/schwarm_cli/client/user_messages.rb +1 -1
- data/lib/schwarm_cli/version.rb +1 -1
- data/schwarm-skill.md +10 -1
- metadata +2 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 5ad711fe3997e1d3b3c18cee54f6621ecc3d895f01f7c09916e5bb1f217ea6c4
|
|
4
|
+
data.tar.gz: 3c0b5c575b1ee49423a547eeadc5a7310109e5ff294f718ee0e3cbd016f25dda
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: a1650f63cca311d44de2f6c6b351a4bb1f81958ec5ce3093ac0a6745f5f1104ae632bcb38386bac177dd03e1274052bb47dd7967f2a0a689de1b9e28dd8227eb
|
|
7
|
+
data.tar.gz: b5696799424c27eb8a7808ff225a461e1573e28ffb4cb2261ecd541687344293e5f115fa743605273b612db9639c61ba1eb1ee70113deaca8f9e5dd26b70dc5d
|
data/README.md
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# schwarm-cli
|
|
2
|
+
|
|
3
|
+
Command-line interface for [Schwarm](https://github.com/getdexter/schwarm) — a
|
|
4
|
+
distributed system that orchestrates Claude Code agents working on tasks in
|
|
5
|
+
parallel. Wraps the Schwarm Public API v2 to manage tasks, repositories,
|
|
6
|
+
skills, agents, and more.
|
|
7
|
+
|
|
8
|
+
## Installation
|
|
9
|
+
|
|
10
|
+
Requires Ruby >= 4.0.
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
gem install schwarm-cli
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
This installs the `schwarm` executable.
|
|
17
|
+
|
|
18
|
+
## Configuration
|
|
19
|
+
|
|
20
|
+
Run the interactive configuration once to point the CLI at your Schwarm
|
|
21
|
+
server and save an API key:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
schwarm configure
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
You'll be prompted for:
|
|
28
|
+
|
|
29
|
+
- **Server URL** (defaults to `https://schwarm.getdexter.net`)
|
|
30
|
+
- **API Key** — create one from your Schwarm server's API Keys page
|
|
31
|
+
|
|
32
|
+
The credentials are saved to `~/.schwarm/config/<env>.json` and the connection
|
|
33
|
+
is tested before saving.
|
|
34
|
+
|
|
35
|
+
## Usage
|
|
36
|
+
|
|
37
|
+
List top-level commands:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
schwarm help
|
|
41
|
+
schwarm tree # full command tree
|
|
42
|
+
schwarm version
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Common workflows:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
schwarm repos list
|
|
49
|
+
schwarm tasks list
|
|
50
|
+
schwarm tasks create --repo <REPO_ID> --name "Fix bug" --prompt "..." --status ready
|
|
51
|
+
schwarm tasks show <TASK_ID>
|
|
52
|
+
schwarm tasks handoff --repo <REPO_ID> --name "Continue WIP"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
For the full set of agent-oriented workflows (dispatching tasks, DAGs,
|
|
56
|
+
handoffs, monitoring, messaging), print the bundled skill:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
schwarm skill
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
This is the same document AI agents read to learn how to drive the CLI, and
|
|
63
|
+
it's kept in sync with the gem at [`cli/schwarm-skill.md`](schwarm-skill.md).
|
|
64
|
+
|
|
65
|
+
## Links
|
|
66
|
+
|
|
67
|
+
- [Schwarm repository](https://github.com/getdexter/schwarm)
|
|
68
|
+
- [Source](https://github.com/getdexter/schwarm/tree/main/cli)
|
|
@@ -4,7 +4,7 @@ module SchwarmCli
|
|
|
4
4
|
class Client
|
|
5
5
|
class UserMessages < Resource
|
|
6
6
|
def create(task_id:, content:)
|
|
7
|
-
post("/api/v2/tasks/#{task_id}/messages", {
|
|
7
|
+
post("/api/v2/tasks/#{task_id}/messages", { message: { content: } }).body
|
|
8
8
|
end
|
|
9
9
|
end
|
|
10
10
|
end
|
data/lib/schwarm_cli/version.rb
CHANGED
data/schwarm-skill.md
CHANGED
|
@@ -97,8 +97,9 @@ Tasks left as `draft` will never run.
|
|
|
97
97
|
**When:** You've dispatched tasks and want to check on them.
|
|
98
98
|
|
|
99
99
|
**Steps:**
|
|
100
|
-
1. List active tasks:
|
|
100
|
+
1. List active tasks (archived excluded by default):
|
|
101
101
|
```bash
|
|
102
|
+
schwarm tasks list
|
|
102
103
|
schwarm tasks list --status claimed
|
|
103
104
|
schwarm tasks list --status ready
|
|
104
105
|
schwarm tasks list --status error
|
|
@@ -224,3 +225,11 @@ for tasks in a repository.
|
|
|
224
225
|
- When building a DAG, create all tasks as drafts first, then start them all.
|
|
225
226
|
- For long prompts, write them to a file and use `--prompt-file`.
|
|
226
227
|
- Run `schwarm <command> help` for full flag documentation on any command.
|
|
228
|
+
- `schwarm tasks list` excludes archived tasks by default. Use `--all` to
|
|
229
|
+
include them or `--status archived` to see only archived.
|
|
230
|
+
- `schwarm sessions list` shows only active sessions (pending/running) by
|
|
231
|
+
default. Use `--all` to include terminal states.
|
|
232
|
+
- All list commands support `--limit N` and `--page N` for pagination. The
|
|
233
|
+
footer shows "showing N of M · page X of Y".
|
|
234
|
+
- Run `schwarm skill` to print this document — useful for piping into context
|
|
235
|
+
or refreshing your knowledge of the available workflows.
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: schwarm-cli
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.
|
|
4
|
+
version: 0.1.3
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Vincent Garrigues
|
|
@@ -86,6 +86,7 @@ executables:
|
|
|
86
86
|
extensions: []
|
|
87
87
|
extra_rdoc_files: []
|
|
88
88
|
files:
|
|
89
|
+
- README.md
|
|
89
90
|
- bin/schwarm
|
|
90
91
|
- lib/schwarm_cli.rb
|
|
91
92
|
- lib/schwarm_cli/client.rb
|