kairos-cli 0.0.3 → 0.0.4

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.
Files changed (2) hide show
  1. package/README.md +25 -18
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # kairos-cli
2
2
 
3
- Local CLI bridge for KairOS agent tools.
3
+ The local command-line bridge for KairOS AI tools.
4
+
5
+ `kairos-cli` lets an AI agent (or you) authenticate once and then call KairOS tools from your machine.
4
6
 
5
7
  ## Install
6
8
 
@@ -8,41 +10,46 @@ Local CLI bridge for KairOS agent tools.
8
10
  npm install -g kairos-cli
9
11
  ```
10
12
 
11
- ## Login
13
+ ## Authenticate
12
14
 
13
15
  ```bash
14
16
  kairos login --api-url https://your-kairos-url.com
15
17
  kairos whoami
16
18
  ```
17
19
 
18
- ## Example commands
20
+ `kairos login` opens a browser consent flow and stores local credentials for future calls.
21
+
22
+ ## Common commands
19
23
 
20
24
  ```bash
21
25
  kairos tools
22
26
  kairos call query_today '{}'
23
27
  kairos call query_tasks '{"activeOnly":true}'
28
+ kairos call create_task '{"title":"Follow up","status":"todo"}'
24
29
  ```
25
30
 
26
- ## Local development
31
+ ## Command summary
27
32
 
28
- From the monorepo root:
33
+ - `kairos login [--api-url <url>] [--no-open] [--timeout <seconds>]`
34
+ - `kairos logout`
35
+ - `kairos whoami`
36
+ - `kairos tools`
37
+ - `kairos call <toolName> '<json>'`
29
38
 
30
- ```bash
31
- pnpm cli:build
32
- pnpm kairos --help
33
- ```
34
-
35
- ## Publish and release
39
+ ## Troubleshooting
36
40
 
37
- `kairos-cli` is published by GitHub Actions (`.github/workflows/release-cli.yml`).
41
+ - `Not authenticated. Run: kairos login`
42
+ - Run `kairos login` again to refresh credentials.
43
+ - Login opened the wrong environment
44
+ - Re-run with explicit URL: `kairos login --api-url https://your-kairos-url.com`
45
+ - Agent/non-browser environment
46
+ - Use `kairos login --no-open`, copy the printed URL, open it manually, then approve.
38
47
 
39
- - Workflow permissions include `id-token: write` for npm trusted publishing support.
40
- - Current publish step also supports token-based auth via `NPM_TOKEN`.
41
- - A `403 Forbidden` during publish means the npm credentials lack publish rights for the package/account.
48
+ ## Local development (monorepo)
42
49
 
43
- Before release troubleshooting, verify:
50
+ From the monorepo root:
44
51
 
45
52
  ```bash
46
- npm whoami
47
- pnpm --filter kairos-cli build
53
+ pnpm cli:build
54
+ pnpm kairos --help
48
55
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kairos-cli",
3
- "version": "0.0.3",
3
+ "version": "0.0.4",
4
4
  "description": "KairOS Agent CLI — login and tool calls",
5
5
  "type": "module",
6
6
  "bin": {