tines 0.0.91 → 0.0.93
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 +56 -0
- package/dist/index.js +807 -476
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# tines
|
|
2
|
+
|
|
3
|
+
The command-line client for [Tines](https://github.com/tbuckley/tines), an issue tracker
|
|
4
|
+
built for humans and their agents: work moves through workflows, every action is on the
|
|
5
|
+
record, and a supervisor hands eligible issues to agents. This package talks to the same
|
|
6
|
+
HTTP API the web app uses.
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
npm install -g tines # or, one-shot with no install:
|
|
10
|
+
npx -y tines --help
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Node 20+. No runtime dependencies. Every push to the repository's `main` publishes a new
|
|
14
|
+
version, so `tines --version` always names the API it was built against.
|
|
15
|
+
|
|
16
|
+
## Pointing it at your Tines
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
tines login --api-key tines_… # key: Settings → API keys in the web app
|
|
20
|
+
tines login --url https://your-tines.example # only for a deployment other than the default
|
|
21
|
+
tines config # what is in effect, and from where
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The URL defaults to `https://tines.tbuckley.dev`. Or set `TINES_API_URL` and `TINES_API_KEY`
|
|
25
|
+
in the environment — that is how agent runs are configured, and the env vars win over the
|
|
26
|
+
stored config. `--url` and `--api-key` on any command win over both.
|
|
27
|
+
|
|
28
|
+
## Everyday commands
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
tines projects list
|
|
32
|
+
tines issues list --project <project>
|
|
33
|
+
tines issues create <project> --title "…" -d @description.md
|
|
34
|
+
tines issues show <project>/<number>
|
|
35
|
+
tines issues move <project>/<number> <action> # a workflow transition
|
|
36
|
+
tines issues comment <project>/<number> - <<'EOF' # body from stdin; @file also works
|
|
37
|
+
…
|
|
38
|
+
EOF
|
|
39
|
+
tines events list --issue <project>/<number>
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Issues are addressed as `<project>/<number>`; schedules as `<project>/<name>`; workflow
|
|
43
|
+
states as `<workflow>/<state>`. Every `list` command returns one page — add `--all-pages`
|
|
44
|
+
for the whole list — and every command takes `--json` for machine-readable output.
|
|
45
|
+
`tines <noun> --help` lists the rest: `workflows`, `context`, `journal`, `schedules`,
|
|
46
|
+
`runners`, `runs`, `routing`, `supervisor`.
|
|
47
|
+
|
|
48
|
+
## Running agents on your own machine
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
tines runner daemon --name laptop --harness claude-code
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
registers this machine as a local runner and polls for work. See
|
|
55
|
+
[docs/runner-daemon.md](https://github.com/tbuckley/tines/blob/main/docs/runner-daemon.md)
|
|
56
|
+
for the flags, token rotation, and keeping it running under launchd or systemd.
|