arbella 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/LICENSE +661 -21
- package/README.md +20 -6
- package/dist/index.js +692 -220
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
Backup and migration for your Claude Code and Codex setup — skills, subagents,
|
|
10
10
|
plugins, hooks, settings, memories — into a private Git repo you own.
|
|
11
11
|
|
|
12
|
-
[](./LICENSE)
|
|
13
13
|
|
|
14
14
|
|
|
15
15
|
|
|
@@ -44,23 +44,24 @@ Needs Node 18+.
|
|
|
44
44
|
```sh
|
|
45
45
|
npm install -g arbella
|
|
46
46
|
arbella --help
|
|
47
|
+
arbella update # later: update arbella itself
|
|
47
48
|
```
|
|
48
49
|
|
|
49
50
|
## What it does
|
|
50
51
|
|
|
51
52
|
```text
|
|
52
|
-
push ~/.claude · ~/.codex ──▶ strip · template ──▶ private repo
|
|
53
|
-
pull private repo
|
|
53
|
+
push ~/.claude · ~/.codex · Cursor ──▶ strip · template ──▶ private repo
|
|
54
|
+
pull private repo ──▶ install · place ──▶ tools + Cursor User data
|
|
54
55
|
```
|
|
55
56
|
|
|
56
|
-
`push` reads the parts of your setup that matter, strips anything secret, swaps machine-specific paths for placeholders, and pushes the result to your repo. `pull` does the reverse: installs the CLIs you don't have, drops files back with this machine's paths, reinstalls plugins and skills, and wires
|
|
57
|
+
`push` reads the parts of your setup that matter, strips anything secret, swaps machine-specific paths for placeholders, and pushes the result to your repo. `pull` does the reverse: installs the CLIs you don't have, drops files back with this machine's paths, reinstalls plugins and skills, and wires shared Claude/Codex instructions back into `CLAUDE.md` and `AGENTS.md`.
|
|
57
58
|
|
|
58
59
|
Two things it deliberately won't do:
|
|
59
60
|
|
|
60
61
|
- **Never commits secrets.** API keys, OAuth tokens, `auth.json`, `.credentials.json` — all excluded, no exceptions. You sign back in after a pull, or carry them yourself with [`arbella secrets`](#arbella-secrets).
|
|
61
62
|
- **Doesn't copy what it can reinstall.** Plugins and registry skills are saved as a list and pulled fresh, so the repo stays small and never goes stale.
|
|
62
63
|
|
|
63
|
-
Supported today: **Claude Code
|
|
64
|
+
Supported today: **Claude Code**, **Codex**, and **Cursor**. Cursor support covers global MCP config, user settings, keybindings, snippets, local skills, skills.sh symlinks, and extension IDs; runtime state and credentials stay out.
|
|
64
65
|
|
|
65
66
|
## Commands
|
|
66
67
|
|
|
@@ -71,6 +72,7 @@ Supported today: **Claude Code** and **Codex**, plus a **Cursor** adapter that q
|
|
|
71
72
|
| [`arbella push`](#arbella-push) | Snapshot your setup and push it — the everyday one |
|
|
72
73
|
| [`arbella pull <url>`](#arbella-pull) | Rebuild your setup on a fresh machine |
|
|
73
74
|
| [`arbella status`](#arbella-status) | Show what a push would change — read-only |
|
|
75
|
+
| [`arbella update`](#arbella-update) | Update arbella itself through npm |
|
|
74
76
|
| [`arbella auth`](#arbella-auth) | Sign in to your repo host |
|
|
75
77
|
| [`arbella secrets`](#arbella-secrets) | Move credentials between machines, off Git |
|
|
76
78
|
|
|
@@ -143,6 +145,16 @@ arbella status --json # pipe it somewhere
|
|
|
143
145
|
|
|
144
146
|
New and modified files, plugin drift, the secrets it would skip. Writes nothing, installs nothing.
|
|
145
147
|
|
|
148
|
+
### `arbella update`
|
|
149
|
+
|
|
150
|
+
Updates the Arbella CLI package itself. It does not touch your backed-up Claude, Codex, or Cursor setup.
|
|
151
|
+
|
|
152
|
+
```sh
|
|
153
|
+
arbella update # npm install -g arbella@latest
|
|
154
|
+
arbella update --version 0.1.2 # pin a specific release
|
|
155
|
+
arbella update --dry-run # show the npm command only
|
|
156
|
+
```
|
|
157
|
+
|
|
146
158
|
### `arbella auth`
|
|
147
159
|
|
|
148
160
|
Handles sign-in to your repo host. You rarely call it yourself — `push` and `pull` sign in on their own when they hit a private repo. It's here for when you'd rather log in ahead of time, or check where you stand.
|
|
@@ -200,4 +212,6 @@ v0.1 — early, but it builds clean, the full test suite passes, and I use it da
|
|
|
200
212
|
|
|
201
213
|
## License
|
|
202
214
|
|
|
203
|
-
|
|
215
|
+
Copyright (c) 2026 Fafoooo.
|
|
216
|
+
|
|
217
|
+
Arbella is licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). See [LICENSE](./LICENSE).
|