@agentic-workspace/workspace-cli 1.0.0-rc.9 → 1.1.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 +28 -25
- package/package.json +1 -1
- package/src/native/bin/darwin-arm64/agentic-workspace +0 -0
- package/src/native/bin/darwin-arm64/agentic-workspace-core +0 -0
- package/src/native/bin/darwin-arm64/artifact.json +1 -1
- package/src/native/bin/darwin-x64/agentic-workspace +0 -0
- package/src/native/bin/darwin-x64/agentic-workspace-core +0 -0
- package/src/native/bin/darwin-x64/artifact.json +1 -1
- package/src/native/bin/linux-arm64/agentic-workspace +0 -0
- package/src/native/bin/linux-arm64/agentic-workspace-core +0 -0
- package/src/native/bin/linux-arm64/artifact.json +1 -1
- package/src/native/bin/linux-x64/agentic-workspace +0 -0
- package/src/native/bin/linux-x64/agentic-workspace-core +0 -0
- package/src/native/bin/linux-x64/artifact.json +1 -1
- package/src/native/bin/win32-arm64/agentic-workspace-core.exe +0 -0
- package/src/native/bin/win32-arm64/agentic-workspace.exe +0 -0
- package/src/native/bin/win32-arm64/artifact.json +1 -1
- package/src/native/bin/win32-x64/agentic-workspace-core.exe +0 -0
- package/src/native/bin/win32-x64/agentic-workspace.exe +0 -0
- package/src/native/bin/win32-x64/artifact.json +1 -1
package/README.md
CHANGED
|
@@ -4,16 +4,13 @@
|
|
|
4
4
|
[](https://www.npmjs.com/package/@agentic-workspace/workspace-cli)
|
|
5
5
|
[](https://crates.io/crates/agentic-workspace-cli)
|
|
6
6
|
|
|
7
|
-
> [!IMPORTANT]
|
|
8
|
-
> **v1.0 release candidates:** Find candidate downloads and release-specific installation instructions on [GitHub Releases](https://github.com/rickardvh/agentic-workspace/releases). Release candidates are prereleases intended for testing.
|
|
9
|
-
|
|
10
7
|
**Persistent operating context and dynamic control for coding agents.**
|
|
11
8
|
|
|
12
9
|
Agentic Workspace (AW) helps coding agents enter a repository with the right guidance, continue unfinished work across sessions, and preserve useful lessons without turning every task into a workflow.
|
|
13
10
|
|
|
14
11
|
It builds on repository instructions and skills with persistent, source-owned context and a small Rust-backed tool surface for exact current information and bounded operations. Keep your existing agent, editor, source tree, tests, and review process; AW connects them to the operating context that matters for the task at hand.
|
|
15
12
|
|
|
16
|
-
[
|
|
13
|
+
[Customise repository behaviour](https://github.com/rickardvh/agentic-workspace/blob/master/docs/customization.md) · [Get started](https://github.com/rickardvh/agentic-workspace#get-started) · [Everyday use](https://github.com/rickardvh/agentic-workspace/blob/master/docs/everyday-use.md) · [Documentation](https://github.com/rickardvh/agentic-workspace/blob/master/docs/index.md) · [Releases](https://github.com/rickardvh/agentic-workspace/releases)
|
|
17
14
|
|
|
18
15
|
## Why AW?
|
|
19
16
|
|
|
@@ -21,7 +18,7 @@ A repository instruction file can explain how to work in a project. By itself, i
|
|
|
21
18
|
|
|
22
19
|
As work spans sessions and agents, that context has to come from somewhere. Without a deliberate home, it tends to disappear into chat, duplicate into prose, or be reconstructed from source, issues, and history.
|
|
23
20
|
|
|
24
|
-
AW keeps only the operating context whose availability can materially change agent
|
|
21
|
+
AW keeps only the operating context whose availability can materially change agent behaviour, then makes the relevant part cheap to reach:
|
|
25
22
|
|
|
26
23
|
| Need | What AW provides |
|
|
27
24
|
| --- | --- |
|
|
@@ -33,15 +30,21 @@ AW keeps only the operating context whose availability can materially change age
|
|
|
33
30
|
|
|
34
31
|
The goal is less repeated explanation, searching, handoff reconstruction, and repair—not a larger prompt or a new workflow to manage.
|
|
35
32
|
|
|
36
|
-
**Small tasks stay small.** A typo fix does not need Planning, Memory, Verification, delegation, or another
|
|
33
|
+
**Small tasks stay small.** A typo fix does not need Planning, Memory, Verification, delegation, or another artefact merely because those capabilities are available.
|
|
37
34
|
|
|
38
35
|
## What using it looks like
|
|
39
36
|
|
|
40
|
-
|
|
37
|
+
AW can help an agent find relevant project guidance and preserve unfinished work
|
|
38
|
+
between sessions. The agent still reads the source, reasons about the design and
|
|
39
|
+
implements changes with its ordinary tools.
|
|
40
|
+
|
|
41
|
+
For example, imagine an API change that spans two sessions in a repository with
|
|
42
|
+
API guidance and verification procedures configured:
|
|
41
43
|
|
|
42
44
|
> Add pagination to the users API without breaking existing clients.
|
|
43
45
|
|
|
44
|
-
|
|
46
|
+
The agent can use AW to find the relevant contract, load a useful implementation
|
|
47
|
+
procedure and identify the checks expected for this change.
|
|
45
48
|
|
|
46
49
|
If work stops partway through, Planning can preserve the intended outcome, accepted progress, unresolved questions, and next action.
|
|
47
50
|
|
|
@@ -57,9 +60,9 @@ The same principle applies to a handoff: preserve enough for the receiving agent
|
|
|
57
60
|
|
|
58
61
|
## How it works
|
|
59
62
|
|
|
60
|
-
**Skills teach procedure. Repository instructions and configuration set policy. Domain owners hold current state and evidence. Tools provide exact current information and controlled operations. The agent supplies
|
|
63
|
+
**Skills teach procedure. Repository instructions and configuration set policy. Domain owners hold current state and evidence. Tools provide exact current information and controlled operations. The agent supplies judgement.**
|
|
61
64
|
|
|
62
|
-
A small repository entry point leads the agent to AW's canonical `workspace-startup` skill. That skill explains how to reach relevant sources, ask the runtime for current facts when they matter, and load
|
|
65
|
+
A small repository entry point leads the agent to AW's canonical `workspace-startup` skill. That skill explains how to reach relevant sources, ask the runtime for current facts when they matter, and load specialised procedures only when useful.
|
|
63
66
|
|
|
64
67
|
The underlying model is deliberately small:
|
|
65
68
|
|
|
@@ -73,6 +76,16 @@ Source code, documentation, tests, decisions, and other canonical repository mat
|
|
|
73
76
|
|
|
74
77
|
[Product model](https://github.com/rickardvh/agentic-workspace/blob/master/docs/package/overview.md) · [Architecture](https://github.com/rickardvh/agentic-workspace/blob/master/docs/architecture.md)
|
|
75
78
|
|
|
79
|
+
## Trust and support
|
|
80
|
+
|
|
81
|
+
**AW is not a sandbox.** Repository-configured commands run with the caller's filesystem and credential authority. Review the repository and its execution routes before allowing them to run. Credentials belong in the host or environment's credential facilities, not checked-in AW state.
|
|
82
|
+
|
|
83
|
+
AW's operation boundaries and verification support do not replace human judgement, independent review, or existing security controls.
|
|
84
|
+
|
|
85
|
+
Exact package identities, installation commands, runtime versions, operating-system support, and prerelease/stable status are deliberately kept in release-bound or generated owners instead of copied into this landing page.
|
|
86
|
+
|
|
87
|
+
[Installation and adoption](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) · [Threat model](https://github.com/rickardvh/agentic-workspace/blob/master/docs/security/threat-model.md) · [Evidence and support](https://github.com/rickardvh/agentic-workspace/blob/master/docs/evidence-and-support.md)
|
|
88
|
+
|
|
76
89
|
## Get started
|
|
77
90
|
|
|
78
91
|
Use the [installation and adoption guide](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) for the release class you intend to run. Stable support, release candidates, and previews have different evidence and support boundaries; exact install commands and platform claims belong to the selected release and its receipts rather than this README.
|
|
@@ -81,7 +94,7 @@ For support-bearing installs, follow the [generated install projection](https://
|
|
|
81
94
|
|
|
82
95
|
### Adopt a repository
|
|
83
96
|
|
|
84
|
-
Installing the runtime and adopting a repository are separate operations. After installing the selected
|
|
97
|
+
Installing the runtime and adopting a repository are separate operations. After installing the selected artefact, run ordinary `start` against the target Git repository:
|
|
85
98
|
|
|
86
99
|
```bash
|
|
87
100
|
agentic-workspace start --target . \
|
|
@@ -89,7 +102,7 @@ agentic-workspace start --target . \
|
|
|
89
102
|
--format json
|
|
90
103
|
```
|
|
91
104
|
|
|
92
|
-
If the repository is not yet adopted and the selected
|
|
105
|
+
If the repository is not yet adopted and the selected artefact includes the current adoption owner, Configuration returns the exact repository-adoption request. Follow that request and execute only the returned authorised action. Adoption establishes the small package-owned host footprint and managed `AGENTS.md` fence; it does **not** invent repository policy, choose optional modules, or create Planning, Memory, or Verification state.
|
|
93
106
|
|
|
94
107
|
### In an adopted repository
|
|
95
108
|
|
|
@@ -105,7 +118,7 @@ For direct inspection, use the same `start` boundary with the actual task. After
|
|
|
105
118
|
|
|
106
119
|
## Your repository, your rules
|
|
107
120
|
|
|
108
|
-
AW is designed to fit around the project rather than
|
|
121
|
+
AW is designed to fit around the project rather than reorganise it.
|
|
109
122
|
|
|
110
123
|
A simplified host repository looks like this:
|
|
111
124
|
|
|
@@ -156,22 +169,12 @@ Agentic Workspace is not an autonomous coding agent. It gives the agent already
|
|
|
156
169
|
|
|
157
170
|
An agent with runtime access can query current owner state and use supported operations. A repository-only reviewer can follow the same canonical skill and generated read profile to recover relevant recorded intent, constraints, progress, and advice, while live machine state, fresh proof, and effect permission remain unknown.
|
|
158
171
|
|
|
159
|
-
The ordinary deterministic product semantics live in a shared Rust core. Native, Python, TypeScript, and JSON-facing surfaces project or bind that authority rather than defining separate workflow
|
|
172
|
+
The ordinary deterministic product semantics live in a shared Rust core. Native, Python, TypeScript, and JSON-facing surfaces project or bind that authority rather than defining separate workflow behaviour. The host project's implementation language does not need to match AW's runtime implementation.
|
|
160
173
|
|
|
161
174
|
Host integrations still differ. Provider independence does not mean every agent host discovers skills identically or every model follows repository guidance perfectly; current support and evidence remain release- and environment-bound.
|
|
162
175
|
|
|
163
176
|
[Evidence and support →](https://github.com/rickardvh/agentic-workspace/blob/master/docs/evidence-and-support.md)
|
|
164
177
|
|
|
165
|
-
## Trust and support
|
|
166
|
-
|
|
167
|
-
**AW is not a sandbox.** Repository-configured commands run with the caller's filesystem and credential authority. Review the repository and its execution routes before allowing them to run. Credentials belong in the host or environment's credential facilities, not checked-in AW state.
|
|
168
|
-
|
|
169
|
-
AW's operation boundaries and verification support do not replace human judgment, independent review, or existing security controls.
|
|
170
|
-
|
|
171
|
-
Exact package identities, installation commands, runtime versions, operating-system support, and prerelease/stable status are deliberately kept in release-bound or generated owners instead of copied into this landing page.
|
|
172
|
-
|
|
173
|
-
[Installation and adoption](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) · [Threat model](https://github.com/rickardvh/agentic-workspace/blob/master/docs/security/threat-model.md) · [Evidence and support](https://github.com/rickardvh/agentic-workspace/blob/master/docs/evidence-and-support.md)
|
|
174
|
-
|
|
175
178
|
## Learn more
|
|
176
179
|
|
|
177
180
|
**Use AW:** [Installation and adoption](https://github.com/rickardvh/agentic-workspace/blob/master/docs/agentic-workspace-install.md) · [Everyday use](https://github.com/rickardvh/agentic-workspace/blob/master/docs/everyday-use.md) · [Configuration](https://github.com/rickardvh/agentic-workspace/blob/master/docs/reference/workspace-config.md)
|
|
@@ -186,6 +189,6 @@ For changes to Agentic Workspace itself, start with the [contributor playbook](h
|
|
|
186
189
|
|
|
187
190
|
Contributions should make useful work easier to complete, continue, or verify while keeping unnecessary context, framework surface, and repository residue low.
|
|
188
191
|
|
|
189
|
-
##
|
|
192
|
+
## Licence
|
|
190
193
|
|
|
191
194
|
[MIT](https://github.com/rickardvh/agentic-workspace/blob/master/LICENSE).
|
package/package.json
CHANGED
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "darwin", "arch": "arm64", "sha256": "7ea5664ba87dc705e2d74b8349006199a84c40372fa049f67e61365fb883cda1", "cli_sha256": "10d83090901bb11693bcb436e02cb108fa49d714b59934d170519167699ccfd1", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "aarch64-apple-darwin", "rust_target": "aarch64-apple-darwin", "rust_toolchain": {"macos_deployment_target": "14.0", "channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "aarch64-apple-darwin", "llvm_version": "22.1.8"}}
|
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "darwin", "arch": "x64", "sha256": "64b440d8f7e88b474807b9921f713be827e3c5dc30f9ed2fa03b8ab6de2b18d6", "cli_sha256": "88c79558d1fce49224578e4173832c87a4fd47ec73c9bcd6a7958545d053aa64", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "x86_64-apple-darwin", "rust_target": "x86_64-apple-darwin", "rust_toolchain": {"macos_deployment_target": "15.0", "channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "x86_64-apple-darwin", "llvm_version": "22.1.8"}}
|
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "linux", "arch": "arm64", "sha256": "618a7ad5c7b01e6219a533453007414aaac587f847dc65584322193acadb93a4", "cli_sha256": "82f022f97212d40dc75acc87bdabcc762a6b77f32bc2d10c2caff0bdcaa5cc88", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "aarch64-unknown-linux-gnu", "rust_target": "aarch64-unknown-linux-gnu", "rust_toolchain": {"channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "aarch64-unknown-linux-gnu", "llvm_version": "22.1.8"}}
|
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "linux", "arch": "x64", "sha256": "91fa185829d009953572adb5950df4c97d9d12bad2a9a5f1009638b5b15c0843", "cli_sha256": "740f0662c0b1966f34bf19c7581191448e2eb281aaeb79b1418ffbea3e7117bc", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "x86_64-unknown-linux-gnu", "rust_target": "x86_64-unknown-linux-gnu", "rust_toolchain": {"channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "x86_64-unknown-linux-gnu", "llvm_version": "22.1.8"}}
|
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "win32", "arch": "arm64", "sha256": "ef5926789e0325f7182cb0408e9bac78b64a6e3bb49cfae9606eb9d76b97a644", "cli_sha256": "c2ef97b7adc551462bb0d7f9c905a4b6942d51dbe34b465c8919a0c8fd61ab4a", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "aarch64-pc-windows-msvc", "rust_target": "aarch64-pc-windows-msvc", "rust_toolchain": {"channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "aarch64-pc-windows-msvc", "llvm_version": "22.1.8"}}
|
|
Binary file
|
|
Binary file
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.
|
|
1
|
+
{"kind": "agentic-workspace/native-npm-artifact/v1", "package_version": "1.1.1", "platform": "win32", "arch": "x64", "sha256": "f45cec7e1fb78e9aacdf213469a38cfb556c985df9349d301516523a02717722", "cli_sha256": "23b9b2d0bbc594b5961b3232c45f6f35bc07720e81e08c4976e7af1a3a819efc", "source_head": "3121f237f6ad2b6dbc8dc4c4aede018f8cd5b626", "source_dirty": false, "profile": "release", "rust_host": "x86_64-pc-windows-msvc", "rust_target": "x86_64-pc-windows-msvc", "rust_toolchain": {"channel": "1.98.1", "declaration_sha256": "887f9be066a15585a2c583578e84b0fcb541126d81546276bad3d2ff00d61167", "release": "1.98.1", "commit_hash": "48a229ceaefd4985c50990b14116b6d856af0985", "commit_date": "2026-09-01", "host": "x86_64-pc-windows-msvc", "llvm_version": "22.1.8"}}
|