@agent-commons/cli 0.4.0 → 0.6.1
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 +22 -0
- package/dist/bin.js +997 -301
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -72,6 +72,22 @@ agc
|
|
|
72
72
|
It guides first-time sign-in, lets you select an agent, and provides shortcuts
|
|
73
73
|
to the main platform areas.
|
|
74
74
|
|
|
75
|
+
## Coding workspace
|
|
76
|
+
|
|
77
|
+
Run `agc code "your task"` inside a project for a local coding session. The
|
|
78
|
+
`agc chat` command remains available. Use `--read-only` to deny local edits and
|
|
79
|
+
commands, or `--no-local` to disable local tools. A root `AGENTS.md` is included
|
|
80
|
+
as project instructions. Resume with `agc code --resume SESSION_ID`.
|
|
81
|
+
|
|
82
|
+
The [VS Code extension](../commons-vscode/README.md) bundles this runtime and adds
|
|
83
|
+
a sidebar, agent/session pickers, and editor context actions. Install its public
|
|
84
|
+
VSIX from the repository releases.
|
|
85
|
+
|
|
86
|
+
Local file tools reject paths outside the project, including symlink escapes.
|
|
87
|
+
Approved commands run with your OS permissions; they are not sandboxed. Blank
|
|
88
|
+
approval answers deny the operation. `y` / `n` apply once; `A` / `N` cache that
|
|
89
|
+
operation type's permission for the session.
|
|
90
|
+
|
|
75
91
|
## Everyday commands
|
|
76
92
|
|
|
77
93
|
```bash
|
|
@@ -82,6 +98,8 @@ agc agents runtime status agt_...
|
|
|
82
98
|
|
|
83
99
|
# Run and chat
|
|
84
100
|
agc run --agent agt_... "Summarize this week"
|
|
101
|
+
agc run --agent agt_... --file ./report.pdf "Summarize the attached report with page references"
|
|
102
|
+
agc run --agent agt_... --attach <library-file-id> "Compare this with our earlier report"
|
|
85
103
|
agc chat --agent agt_...
|
|
86
104
|
|
|
87
105
|
# Sessions and tasks
|
|
@@ -162,6 +180,10 @@ operations to an agent. Use the relevant local-tool flags shown by
|
|
|
162
180
|
`agc run --help` and review the requested scope before enabling write or
|
|
163
181
|
execution access.
|
|
164
182
|
|
|
183
|
+
`agc run --file` uploads and attaches up to ten files, each at most 25 MB.
|
|
184
|
+
Use `--attach` to reuse a Library file without uploading it again. Both flags
|
|
185
|
+
can be repeated; attached files remain available in the session.
|
|
186
|
+
|
|
165
187
|
## Configuration and environment variables
|
|
166
188
|
|
|
167
189
|
```bash
|