agentscfg 0.1.0-alpha.3 → 0.1.0
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 +12 -10
- package/dist/cli.cjs +482 -377
- package/dist/cli.js +3 -3
- package/package.json +7 -5
- package/EPOCH_SEMVER.md +0 -34
package/README.md
CHANGED
|
@@ -9,7 +9,6 @@ config for Claude Code, OpenCode, and Codex CLI.
|
|
|
9
9
|
npm install -g agentscfg
|
|
10
10
|
# or
|
|
11
11
|
npx agentscfg <command>
|
|
12
|
-
bunx agentscfg <command>
|
|
13
12
|
```
|
|
14
13
|
|
|
15
14
|
## Quick Start
|
|
@@ -17,7 +16,7 @@ bunx agentscfg <command>
|
|
|
17
16
|
```bash
|
|
18
17
|
agentscfg init
|
|
19
18
|
# edit .agentscfg/instructions/* and .agentscfg/skills/*
|
|
20
|
-
agentscfg
|
|
19
|
+
agentscfg gen --dry-run
|
|
21
20
|
agentscfg diff
|
|
22
21
|
agentscfg gen
|
|
23
22
|
agentscfg import --from codex
|
|
@@ -28,9 +27,8 @@ agentscfg import --from codex
|
|
|
28
27
|
```text
|
|
29
28
|
init [--force]
|
|
30
29
|
validate
|
|
31
|
-
plan [--to claude,opencode,codex] [--json]
|
|
32
30
|
diff [--to ...]
|
|
33
|
-
gen [--to ...] [--remove] [--adopt] [--force] [--allow-dirty]
|
|
31
|
+
gen [--to ...] [--remove] [--adopt] [--force] [--allow-dirty] [--dry-run]
|
|
34
32
|
import --from <tool>
|
|
35
33
|
doctor
|
|
36
34
|
```
|
|
@@ -63,7 +61,7 @@ Run `agentscfg <command> --help` for detailed help on each command.
|
|
|
63
61
|
## Outputs
|
|
64
62
|
|
|
65
63
|
- Claude Code: `CLAUDE.md`, `.claude/skills/<skill>/...`
|
|
66
|
-
- OpenCode: `.opencode/agent/
|
|
64
|
+
- OpenCode: `.opencode/skill/<skill>/...` (agent/config files come from `.agentscfg/targets/opencode/**`)
|
|
67
65
|
- Codex CLI: `AGENTS.md`, `.codex/skills/<skill>/...`
|
|
68
66
|
|
|
69
67
|
### Target Mappings
|
|
@@ -82,10 +80,13 @@ MCP config:
|
|
|
82
80
|
## Managed Files
|
|
83
81
|
|
|
84
82
|
- Generated files include a `agentscfg:generated ... sha256=...` marker.
|
|
85
|
-
-
|
|
86
|
-
|
|
83
|
+
- By default, gen will not overwrite unmanaged files unless you pass `--adopt`
|
|
84
|
+
or the file already contains the marker.
|
|
87
85
|
- If a generated file's hash marker does not match, gen refuses to overwrite
|
|
88
86
|
unless `--force` is provided.
|
|
87
|
+
- `--remove` is disabled unless `managed.allowRemove` is set to true.
|
|
88
|
+
- Managed tracking is stored in `.agentscfg/.managed.json`. If it's missing, run
|
|
89
|
+
`agentscfg gen --adopt` to create it.
|
|
89
90
|
- `gen` refuses to run on a dirty git working tree unless `--allow-dirty` is set.
|
|
90
91
|
|
|
91
92
|
## Tips
|
|
@@ -104,7 +105,8 @@ CLAUDE.md
|
|
|
104
105
|
## Development
|
|
105
106
|
|
|
106
107
|
```bash
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
108
|
+
npm install
|
|
109
|
+
npm test
|
|
110
|
+
npm run build
|
|
111
|
+
npm run tsc
|
|
110
112
|
```
|