vespin 0.1.0 → 0.2.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 +1 -1
- package/package.json +2 -2
- package/skills/vespin/SKILL.md +7 -7
- package/vespin.mjs +653 -524
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# vespin
|
|
2
2
|
|
|
3
|
-
[Vespin](https://vespin.dev) from your terminal: work with your tasks,
|
|
3
|
+
[Vespin](https://vespin.dev) from your terminal: work with your tasks, their descriptions,
|
|
4
4
|
and coding agents from a shell, as a person or as a coding agent calling it.
|
|
5
5
|
|
|
6
6
|
## Install
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "vespin",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Vespin from your terminal: tasks,
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Vespin from your terminal: tasks, their descriptions, and coding agents, for people and scripts",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"homepage": "https://vespin.dev",
|
|
7
7
|
"repository": {
|
package/skills/vespin/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vespin
|
|
3
|
-
description: Drive Vespin from a shell with the `vespin` command: create tasks, read and write their
|
|
3
|
+
description: Drive Vespin from a shell with the `vespin` command: create tasks, read and write their descriptions, start coding agents and wait on them, check out an agent's branch, and answer the inbox threads agents post. Load it when asked to work with Vespin tasks, their descriptions, agents, or inbox from a terminal, to script or pipe Vespin, or to wait on an agent and bring its branch local. Prefer Vespin's MCP server only when you have no shell.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# vespin
|
|
@@ -25,7 +25,7 @@ vespin agent wait <agent-id> --timeout 1800 # exit code says how the turn ende
|
|
|
25
25
|
vespin agent checkout <agent-id> # fetch its branch and check it out here
|
|
26
26
|
```
|
|
27
27
|
|
|
28
|
-
- `task create` takes the repository from this folder's `origin` (override with `-R owner/name`). With `-q` it prints the task id, then the agent id. `--start` hands the agent the
|
|
28
|
+
- `task create` takes the repository from this folder's `origin` (override with `-R owner/name`). With `-q` it prints the task id, then the agent id. `--start` hands the agent the description (`-F description.md`); `--prompt <file|->` hands it a prompt instead.
|
|
29
29
|
- To see the work live, use `vespin agent logs <id> --follow`. Without `--follow` it prints the transcript so far.
|
|
30
30
|
- `agent checkout` must run inside a clone of the task's repository. `agent view <id>` prints the branch, pull request, and checks.
|
|
31
31
|
- Tasks are named by id, number, or key (`ACME-42`). Agents and threads are named by id.
|
|
@@ -35,14 +35,14 @@ Other commands:
|
|
|
35
35
|
| Command | What it does |
|
|
36
36
|
| --- | --- |
|
|
37
37
|
| `task list [--mine] [--status s]` · `task view <task>` · `task update <task> [--status] [--priority] [--assignee] [--name]` | Find, read, and change tasks; `--status done` marks one done |
|
|
38
|
-
| `
|
|
38
|
+
| `description show <task>` · `description edit <task> -F <file\|->` | Print the description as Markdown; replace it whole |
|
|
39
39
|
| `agent start <task> [-F prompt] [--model m --effort e] [--branch b] [--cloud\|--on <device>] [--follow\|--wait]` | Start an agent; `vespin models` lists `--model` and `--effort` values |
|
|
40
|
-
| `agent list [<task>]` · `agent view <id>` | Agents, newest first; one agent's status |
|
|
40
|
+
| `agent list [<task>] [--offset n]` · `agent view <id>` | Agents, newest first, the workspace's 50 a page (`--offset` the `nextOffset` it printed); one agent's status |
|
|
41
41
|
| `agent send <id> -F <msg\|->` · `agent stop <id>` | Message an agent; stop its turn (what it pushed stays) |
|
|
42
42
|
| `inbox list [--unread]` · `inbox view <thread>` | Threads agents posted, and one thread with its open ask |
|
|
43
43
|
| `inbox answer <thread> <option>` · `inbox answer <thread> -F <json\|->` · `inbox reply <thread> -F <msg\|->` · `inbox close <thread>` | Answer a decide's option, `done` for a to-do, or a form as JSON by field; write on the thread; close it |
|
|
44
44
|
|
|
45
|
-
`
|
|
45
|
+
`description edit` replaces the whole description, so run `description show` first and edit that; piped, `show` prints JSON, so take its `body` (`jq -r .body`). Run `vespin <group> --help` for any flag not listed here.
|
|
46
46
|
|
|
47
47
|
## Conventions
|
|
48
48
|
|
|
@@ -76,10 +76,10 @@ b=$(echo "Update the docs for the redirect" | vespin agent start ACME-42 -F - -q
|
|
|
76
76
|
vespin agent wait "$a" && vespin agent wait "$b" && vespin agent checkout "$a"
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
Edit a
|
|
79
|
+
Edit a description in a pipe:
|
|
80
80
|
|
|
81
81
|
```sh
|
|
82
|
-
vespin
|
|
82
|
+
vespin description show ACME-42 | jq -r .body | sed 's/- \[ \] Tests/- [x] Tests/' | vespin description edit ACME-42 -F -
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
Answer the first unread thread:
|