@shadowclone/cli 0.0.12 → 0.0.13
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/.claude-plugin/marketplace.json +4 -2
- package/PRIVACY.md +25 -0
- package/README.md +32 -20
- package/dist/_.._/web/client/index.html +23 -13
- package/dist/shadowclone.js +426 -417
- package/dist/web/index-dzztba9n.css +1 -0
- package/dist/web/index-pty3xg03.js +134 -0
- package/evals.md +29 -25
- package/package.json +10 -2
- package/plugins/shadowclone/.claude-plugin/plugin.json +17 -0
- package/plugins/shadowclone/.codex-plugin/plugin.json +46 -0
- package/plugins/shadowclone/.codexignore +4 -0
- package/plugins/shadowclone/.mcp.json +8 -0
- package/plugins/shadowclone/LICENSE +21 -0
- package/plugins/shadowclone/README.md +17 -0
- package/plugins/shadowclone/SECURITY.md +5 -0
- package/plugins/shadowclone/assets/agent-builds.jpg +0 -0
- package/plugins/shadowclone/assets/shadowclone-mark.svg +42 -0
- package/plugins/shadowclone/mcp.json +10 -0
- package/plugins/shadowclone/plugin.json +49 -0
- package/plugins/shadowclone/skills/setup-shadowclone/SKILL.md +53 -0
- package/plugins/shadowclone/skills/setup-shadowclone/scripts/check-cli.mjs +37 -0
- package/.claude-plugin/hooks/hooks.json +0 -35
- package/.claude-plugin/plugin.json +0 -5
- package/dist/web/index-174jt7gq.css +0 -1
- package/dist/web/index-1ezbn24z.js +0 -133
|
@@ -3,11 +3,13 @@
|
|
|
3
3
|
"owner": {
|
|
4
4
|
"name": "Shadowclone"
|
|
5
5
|
},
|
|
6
|
+
"description": "Install Shadowclone with agent-led local setup and explicit consent.",
|
|
6
7
|
"plugins": [
|
|
7
8
|
{
|
|
8
9
|
"name": "shadowclone",
|
|
9
|
-
"source": "
|
|
10
|
-
"
|
|
10
|
+
"source": "./plugins/shadowclone",
|
|
11
|
+
"strict": true,
|
|
12
|
+
"description": "Set up and maintain portable coding-agent skills with explicit local consent"
|
|
11
13
|
}
|
|
12
14
|
]
|
|
13
15
|
}
|
package/PRIVACY.md
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Privacy
|
|
2
|
+
|
|
3
|
+
Shadowclone runs on your machine. It does not operate a collection service and does not add telemetry.
|
|
4
|
+
|
|
5
|
+
## What it reads
|
|
6
|
+
|
|
7
|
+
Each session, memory, repository, and skill source is disabled until you consent to that source. Setup asks separately about session learning, skill maintenance, and background learning. You can use the browser build editor without enabling learning.
|
|
8
|
+
|
|
9
|
+
Shadowclone excludes tool results, tool-returned file contents, thinking blocks, and data-access results from learning. It resolves eligible text through its redaction boundary before model work. Redaction reduces exposure but does not guarantee anonymity, so use only material you are authorized to send.
|
|
10
|
+
|
|
11
|
+
## What leaves your machine
|
|
12
|
+
|
|
13
|
+
Opening the browser editor and using the local MCP server do not send data to Shadowclone. Optional learning, skill drafting, build descriptions, and delegated runs use an agent CLI you choose. Consented, redacted inputs go directly through that provider and are governed by its terms.
|
|
14
|
+
|
|
15
|
+
The build description action sends selected skill titles and redacted summaries. It does not send skill bodies, file paths, repository names, or ownership metadata.
|
|
16
|
+
|
|
17
|
+
## Local storage and removal
|
|
18
|
+
|
|
19
|
+
Configuration, evidence, revisions, generated skills, and installation records stay in Shadowclone's local state directory or in files you review before applying. Disable background learning with `shadowclone learning disable`, stop automatic skill edits with `shadowclone skills automatic off`, or remove recorded state with `shadowclone forget --all`.
|
|
20
|
+
|
|
21
|
+
Uninstalling the plugin removes its packaged setup workflow. Use the CLI removal commands for locally installed guidance and state.
|
|
22
|
+
|
|
23
|
+
## Questions and reports
|
|
24
|
+
|
|
25
|
+
Use [GitHub issues](https://github.com/theonly1me/shadowclone/issues) for privacy questions that contain no sensitive data. Follow [the security policy](SECURITY.md) when a report needs private material.
|
package/README.md
CHANGED
|
@@ -6,6 +6,28 @@ Shadowclone maintains the skills, instructions, and checks that help **Claude Co
|
|
|
6
6
|
|
|
7
7
|
## Get started
|
|
8
8
|
|
|
9
|
+
### Let your agent set it up
|
|
10
|
+
|
|
11
|
+
In Claude Code, add and install the plugin:
|
|
12
|
+
|
|
13
|
+
```text
|
|
14
|
+
/plugin marketplace add theonly1me/shadowclone
|
|
15
|
+
/plugin install shadowclone@shadowclone
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
In Codex, add the marketplace and install **Shadowclone** from the Plugins Directory:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
codex plugin marketplace add theonly1me/shadowclone
|
|
22
|
+
codex plugin add shadowclone@shadowclone
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Then tell the agent: **Set up Shadowclone.** The packaged setup skill checks the CLI version, offers installation or an upgrade when needed, asks you for three separate consent choices, installs native guidance for detected agents, and prints the local build URL. This setup flow requires CLI 0.0.13 or newer. It never uses elevated privileges or chooses data access for you.
|
|
26
|
+
|
|
27
|
+
Cursor, Antigravity, and other skill-compatible agents can use the portable [`setup-shadowclone` skill](plugins/shadowclone/skills/setup-shadowclone/SKILL.md). Once any supported agent completes setup, Shadowclone synchronizes native guidance across the detected agents on your machine.
|
|
28
|
+
|
|
29
|
+
### Set it up manually
|
|
30
|
+
|
|
9
31
|
Install the CLI:
|
|
10
32
|
|
|
11
33
|
```bash
|
|
@@ -16,34 +38,24 @@ npm install -g @shadowclone/cli
|
|
|
16
38
|
| --- | --- | --- | ---: |
|
|
17
39
|
| 1 | `shadowclone init` | Answer three questions about learning and skill maintenance | About 1 minute |
|
|
18
40
|
| 2 | `shadowclone learn --deep` | Learn from enabled past sessions; repeat if more history remains | Up to 5 minutes per run |
|
|
19
|
-
| 3 | `shadowclone
|
|
41
|
+
| 3 | `shadowclone learning pending` and `shadowclone skills pending` | Review learned rules, scope, and publication before relying on them | About 1 minute |
|
|
20
42
|
|
|
21
|
-
Setup takes about two to three minutes, excluding learning. Deep learning needs an installed and authenticated `claude`, `codex`, or `cursor-agent` CLI.
|
|
43
|
+
Setup takes about two to three minutes, excluding learning. Deep learning needs an installed and authenticated `claude`, `codex`, or `cursor-agent` CLI. Claude Code learning on Linux needs `bwrap` and `socat` for its sandbox.
|
|
22
44
|
|
|
23
45
|
**Skip learning.** Run `shadowclone wizard` by itself if you do not want Shadowclone to read sessions or call a model. It starts from an empty active environment and lets you choose a build locally.
|
|
24
46
|
|
|
25
|
-
|
|
47
|
+
Run `shadowclone` to see the current result and next action. Use `shadowclone wizard` to browse optional workflow skills in a browser.
|
|
26
48
|
|
|
27
49
|
## Evaluations
|
|
28
50
|
|
|
29
|
-
The preference study
|
|
51
|
+
The preference study compared agent alone, existing user skills, those skills plus Shadowclone setup, and setup plus deep learning on GPT-6 Sol, GPT-6 Luna, Sonnet 5.5, and Opus 5.5. After corrected scoring, deep learning over existing skills was +10.0, -2.5, +9.7, and +7.3 percentage points respectively, with every 95% interval including zero. It recovered a concrete review-reply preference across all four models. The study covers one participant and one synthetic repository. [Read all four setups, corrected results, and limitations](evals.md).
|
|
30
52
|
|
|
31
|
-
|
|
|
53
|
+
| Preferences followed | Sol | Luna | Sonnet | Opus |
|
|
32
54
|
| --- | ---: | ---: | ---: | ---: |
|
|
33
|
-
| Agent alone | 72% | 73% |
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
38
|
-
Here is what changed in practice. Each cell compares the agent alone with Shadowclone skills and deep learning.
|
|
39
|
-
|
|
40
|
-
| Preference | GPT-6 Sol | GPT-6 Luna | Sonnet 5.5 | Opus 5.5 |
|
|
41
|
-
| --- | ---: | ---: | ---: | ---: |
|
|
42
|
-
| Review reply preferences | 2 of 6 → 6 of 6 | 2 of 6 → 6 of 6 | 0 of 6 → 6 of 6 | 0 of 6 → 6 of 6 |
|
|
43
|
-
| Failing test first | 0 of 3 → 3 of 3 | 0 of 3 → 2 of 3 | 0 of 3 → 0 of 3 | 0 of 3 → 2 of 3 |
|
|
44
|
-
| Pull request checklist | 0 of 3 → 3 of 3 | 3 of 3 → 3 of 3 | 0 of 3 → 1 of 3 | 2 of 3 → 3 of 3 |
|
|
45
|
-
|
|
46
|
-
Skills with deep learning beat the agent alone on all four agents by 15 to 25 points. The gain is statistically clear on GPT-6 Sol and Opus 5.5, and directional on the other two. The participant's existing skills scored in the same range and slightly higher on GPT-6 Luna. [Read the tasks, intervals, and limitations](evals.md).
|
|
55
|
+
| Agent alone | 72% | 73% | 59% | 59% |
|
|
56
|
+
| Existing user skills | 87% | 91% | 70% | 79% |
|
|
57
|
+
| Existing skills plus Shadowclone setup | 84% | 83% | 72% | 72% |
|
|
58
|
+
| Setup plus deep learning | 97% | 88% | 80% | 86% |
|
|
47
59
|
|
|
48
60
|
## Privacy comes first
|
|
49
61
|
|
|
@@ -60,7 +72,7 @@ Skills with deep learning beat the agent alone on all four agents by 15 to 25 po
|
|
|
60
72
|
|
|
61
73
|
**Redaction is a boundary, not an anonymity guarantee.** Tool results, tool-returned file contents, thinking blocks, and data-access results are excluded from learning. Use only sources and repositories you are authorized to send to the selected provider.
|
|
62
74
|
|
|
63
|
-
**Removal stays in your control.** Disable background learning with `shadowclone learning disable`, stop automatic skill edits with `shadowclone skills automatic off`, or remove recorded state with `shadowclone forget --all`. See [data handling](docs/data-handling.md) and [enterprise controls](docs/architecture/07-enterprise.md) for sources, storage, managed policy, and removal details.
|
|
75
|
+
**Removal stays in your control.** Disable background learning with `shadowclone learning disable`, stop automatic skill edits with `shadowclone skills automatic off`, or remove recorded state with `shadowclone forget --all`. See the [privacy policy](PRIVACY.md), [data handling](docs/data-handling.md), and [enterprise controls](docs/architecture/07-enterprise.md) for sources, storage, managed policy, and removal details.
|
|
64
76
|
|
|
65
77
|
## Guides
|
|
66
78
|
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
|
|
23
23
|
|
|
24
24
|
|
|
25
|
-
<link rel="stylesheet" crossorigin href="../../../web/index-
|
|
25
|
+
<link rel="stylesheet" crossorigin href="../../../web/index-dzztba9n.css"><script type="module" crossorigin src="../../../web/index-pty3xg03.js"></script></head>
|
|
26
26
|
<body>
|
|
27
27
|
<div class="frame">
|
|
28
28
|
<header class="masthead">
|
|
@@ -76,26 +76,36 @@
|
|
|
76
76
|
<section
|
|
77
77
|
id="constellation"
|
|
78
78
|
class="constellation"
|
|
79
|
-
aria-label="Skill
|
|
79
|
+
aria-label="Skill constellation"
|
|
80
80
|
>
|
|
81
|
+
<div id="constellation-status" class="constellation-status" role="status">
|
|
82
|
+
<p id="constellation-status-text">Loading your skills…</p>
|
|
83
|
+
<button id="retry-build" class="quiet-button" hidden>Retry loading skills</button>
|
|
84
|
+
</div>
|
|
85
|
+
<div class="constellation-controls" aria-label="Constellation controls">
|
|
86
|
+
<button id="fit-constellation" class="quiet-button">Fit</button>
|
|
87
|
+
<button id="reset-constellation" class="quiet-button">Reset</button>
|
|
88
|
+
<button
|
|
89
|
+
id="toggle-constellation-view"
|
|
90
|
+
class="quiet-button"
|
|
91
|
+
aria-controls="constellation-map constellation-list"
|
|
92
|
+
aria-pressed="false"
|
|
93
|
+
>
|
|
94
|
+
Map / list
|
|
95
|
+
</button>
|
|
96
|
+
</div>
|
|
81
97
|
<svg
|
|
82
98
|
id="starfield"
|
|
83
99
|
class="starfield"
|
|
84
|
-
viewBox="0 0 600 900"
|
|
85
|
-
preserveAspectRatio="none"
|
|
86
100
|
aria-hidden="true"
|
|
87
101
|
></svg>
|
|
88
102
|
<svg
|
|
89
|
-
id="
|
|
90
|
-
class="
|
|
91
|
-
aria-
|
|
103
|
+
id="constellation-map"
|
|
104
|
+
class="constellation-map"
|
|
105
|
+
aria-label="Skills grouped into navigable hubs"
|
|
92
106
|
></svg>
|
|
93
|
-
<div id="
|
|
94
|
-
<
|
|
95
|
-
<span id="tree-origin"
|
|
96
|
-
><img src="../../../web/shadowclone-mark-w6a76wqy.svg" alt="" /></span>
|
|
97
|
-
</div>
|
|
98
|
-
<p class="tree-hint">Select a star to inspect its skill.</p>
|
|
107
|
+
<div id="constellation-list" class="constellation-list"></div>
|
|
108
|
+
<p class="tree-hint">Select a category to expand it or a skill to inspect it. Drag to pan and scroll to zoom.</p>
|
|
99
109
|
</section>
|
|
100
110
|
|
|
101
111
|
<aside class="build-panel" aria-label="Your character build">
|