@astralos/cli 0.1.1 → 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.
- package/README.md +31 -0
- package/dist/astral.js +19213 -3797
- 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.
|