@astralos/cli 0.1.1 → 0.1.2

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 (3) hide show
  1. package/README.md +31 -0
  2. package/dist/astral.js +19213 -3797
  3. package/package.json +4 -1
package/README.md CHANGED
@@ -22,11 +22,42 @@ astral whoami
22
22
  astral workspace list
23
23
  astral workspace current
24
24
  astral tools list
25
+ astral tools describe code.list_repos
26
+ astral tools call code.list_repos --input '{}'
25
27
  astral link
26
28
  astral deploy
29
+ astral agent-setup
30
+ astral mcp
27
31
  ```
28
32
 
29
33
  `astral login` uses your browser to approve this terminal. `astral link` connects
30
34
  the current folder to a site. `astral deploy` creates a preview by default.
31
35
 
32
36
  Use `astral --help` or `astral <command> --help` for command details.
37
+
38
+ `astral call` and `astral tools call` share the same JSON input options:
39
+ `--input <json>` or `--input-file <file|->`. Generated commands use kebab-case
40
+ names and flags. For example, `code.list_repos` becomes `astral code list-repos`.
41
+ Group help includes catalog commands when you are signed in.
42
+
43
+ ## Agent instructions
44
+
45
+ `astral agent-setup` prints a marked AGENTS.md snippet. It needs no sign-in.
46
+ Use `astral agent-setup --write` to write it into AGENTS.md in the current
47
+ folder, or `--write <file>` for another file. Later writes replace the marked
48
+ block and keep the surrounding instructions.
49
+
50
+ ## MCP
51
+
52
+ Configure your MCP client to run `astral mcp` with stdio transport. Sign in
53
+ with `astral login` first, or supply `ASTRAL_TOKEN` in the client's environment.
54
+ The server loads your catalog at startup. Catalog names such as
55
+ `code.list_repos` become MCP names such as `code__list_repos`; long or colliding
56
+ names get a stable hash suffix. Tool descriptions and JSON input schemas
57
+ come from the catalog.
58
+
59
+ Approval-required calls return an error with an approval link. After a person
60
+ approves it, retry the same tool with identical arguments to replay the approval.
61
+ Alternatively, run `astral --wait mcp` to wait and replay automatically. Set
62
+ `--wait-timeout <seconds>` to change the 900-second deadline. Diagnostics go to
63
+ stderr; stdout carries only MCP messages.