snapkitty
developer-tools
typescript
SNAPKITTYWEST commited on
Commit
d78dc7a
ยท
verified ยท
1 Parent(s): 4e430ea

Sync with GitHub, license metadata from LICENSE files, commercial license notice

Browse files

metadata license: None -> other (sovereign-source-license)
README: License section appended

Files changed (1) hide show
  1. README.md +130 -116
README.md CHANGED
@@ -1,116 +1,130 @@
1
- # SnapKitty Sovereign IDE Extensions
2
-
3
- Free VS Code extensions for the [SnapKitty Sovereign OS](https://collectivekitty.com) โ€” bringing the MAGMA governance protocol and live WORM chain state directly into your editor.
4
-
5
- ---
6
-
7
- ## Extensions
8
-
9
- ### `magma-protocol` โ€” the command bus
10
-
11
- Seal code, anchor decisions, and route agent instructions without leaving VS Code.
12
-
13
- | Keybinding | Command | Description |
14
- |------------|---------|-------------|
15
- | `Ctrl+Shift+M` | Open Panel | MAGMA terminal โ€” type ยง or $ instructions |
16
- | `Ctrl+Shift+S` | Seal selection | Seal highlighted code to WORM chain |
17
- | `Ctrl+Shift+L` | Seal file | Seal current file SHA-256 to chain |
18
- | Right-click | Seal / Anchor | Context menu on any file or selection |
19
-
20
- **Auto-completions** โ€” type `ยง` or `$` and get tier/shorthand suggestions inline.
21
-
22
- **On save** (optional) โ€” auto-seals every saved file hash to the chain.
23
-
24
- **On commit** โ€” seals every git commit hash to LEDGE automatically.
25
-
26
- ### `sovereign-status` โ€” live chain state in the status bar
27
-
28
- ```
29
- $(lock) 7f3a1b2cโ€ฆ ยท 142 $(circuit-board) 24 AGENTS
30
- ```
31
-
32
- Polls your SnapKitty OS every 30 seconds. Click either item to open the MAGMA panel or show the chain head.
33
-
34
- ---
35
-
36
- ## Quick start
37
-
38
- ```bash
39
- # Clone this repo
40
- git clone https://github.com/snapkittywest/sovereign-ide-extensions
41
- cd sovereign-ide-extensions
42
-
43
- # Install and compile magma-protocol
44
- cd magma-protocol
45
- npm install && npm run compile
46
- # Press F5 in VS Code to launch Extension Development Host
47
-
48
- # Install and compile sovereign-status
49
- cd ../sovereign-status
50
- npm install && npm run compile
51
- ```
52
-
53
- Requires a running [SnapKitty OS](https://collectivekitty.com) instance at `http://localhost:3000` (configurable via settings).
54
-
55
- ---
56
-
57
- ## MAGMA Protocol quick reference
58
-
59
- ```
60
- TIER PREFIXES $ SHORTHANDS
61
- ๐Ÿ”’ SEAL CIPHER $seal โ€” cryptographic seal
62
- ๐Ÿ“œ ANCHOR MNEMEX $anchor โ€” immutable WORM write
63
- โšก FLUX HERALD $flux โ€” state transition / broadcast
64
- ๐Ÿ‘ SENTINEL SENTINEL $watch โ€” security monitor (auto-urgent)
65
- ๐Ÿฆ VAULT VAULT $vault โ€” financial authorization
66
- ๐Ÿ”ฎ ORACLE ORACLE $query โ€” knowledge graph query
67
- โš’๏ธ FORGE FORGE $forge โ€” build / deploy action
68
- ๐Ÿง  NOVA NOVA $ask โ€” synthetic intelligence
69
- ๐Ÿ’€ LOC LOC โ† binary outcome. no retry.
70
- ```
71
-
72
- ---
73
-
74
- ## Settings
75
-
76
- | Setting | Default | Description |
77
- |---------|---------|-------------|
78
- | `magma.osUrl` | `http://localhost:3000` | SnapKitty OS base URL |
79
- | `magma.sealOnSave` | `false` | Auto-seal file hash on save |
80
- | `magma.sealOnCommit` | `true` | Seal git commit hash to LEDGE |
81
- | `magma.agentDefault` | `FORGE` | Default agent for instructions |
82
- | `sovereignStatus.pollInterval` | `30` | Status bar poll interval (seconds) |
83
-
84
- ---
85
-
86
- ## Architecture
87
-
88
- ```
89
- โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
90
- โ”‚ VS Code โ”‚
91
- โ”‚ magma-protocol extension ยท sovereign-status โ”‚
92
- โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
93
- โ”‚
94
- โ–ผ
95
- โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
96
- โ”‚ SnapKitty OS (localhost:3000) โ”‚
97
- โ”‚ /api/labs/ledge/seal ยท /api/merkle/root โ”‚
98
- โ”‚ WORM chain ยท 24 agents ยท MAGMA ยท Merkle root โ”‚
99
- โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
100
- ```
101
-
102
- ---
103
-
104
- ## Related
105
-
106
- - [LEDGE](https://github.com/snapkittywest/ledge) โ€” open-source WORM chain (Rust + WASM)
107
- - [SnapKitty OS](https://collectivekitty.com) โ€” the sovereign AI operating system
108
- - [Live chain explorer](https://collectivekitty.com/labs/ledge)
109
- - [Honeypot live feed](https://collectivekitty.com/labs/sentinel)
110
-
111
- ---
112
-
113
- *MIT License ยท SnapKitty Collective ยท 2026*
114
- *"The development environment that seals every decision."*
115
-
116
- ![](https://sovereign-analytics.snapkittywest.workers.dev/canary/sovereign-ide-extensions)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: other
3
+ license_name: sovereign-source-license
4
+ license_link: https://huggingface.co/Snapkitty/sovereign-ide-extensions/blob/main/LICENSE
5
+ tags:
6
+ - snapkitty
7
+ ---
8
+
9
+ # SnapKitty Sovereign IDE Extensions
10
+
11
+ Free VS Code extensions for the [SnapKitty Sovereign OS](https://collectivekitty.com) โ€” bringing the MAGMA governance protocol and live WORM chain state directly into your editor.
12
+
13
+ ---
14
+
15
+ ## Extensions
16
+
17
+ ### `magma-protocol` โ€” the command bus
18
+
19
+ Seal code, anchor decisions, and route agent instructions without leaving VS Code.
20
+
21
+ | Keybinding | Command | Description |
22
+ |------------|---------|-------------|
23
+ | `Ctrl+Shift+M` | Open Panel | MAGMA terminal โ€” type ยง or $ instructions |
24
+ | `Ctrl+Shift+S` | Seal selection | Seal highlighted code to WORM chain |
25
+ | `Ctrl+Shift+L` | Seal file | Seal current file SHA-256 to chain |
26
+ | Right-click | Seal / Anchor | Context menu on any file or selection |
27
+
28
+ **Auto-completions** โ€” type `ยง` or `$` and get tier/shorthand suggestions inline.
29
+
30
+ **On save** (optional) โ€” auto-seals every saved file hash to the chain.
31
+
32
+ **On commit** โ€” seals every git commit hash to LEDGE automatically.
33
+
34
+ ### `sovereign-status` โ€” live chain state in the status bar
35
+
36
+ ```
37
+ $(lock) 7f3a1b2cโ€ฆ ยท 142 $(circuit-board) 24 AGENTS
38
+ ```
39
+
40
+ Polls your SnapKitty OS every 30 seconds. Click either item to open the MAGMA panel or show the chain head.
41
+
42
+ ---
43
+
44
+ ## Quick start
45
+
46
+ ```bash
47
+ # Clone this repo
48
+ git clone https://github.com/snapkittywest/sovereign-ide-extensions
49
+ cd sovereign-ide-extensions
50
+
51
+ # Install and compile magma-protocol
52
+ cd magma-protocol
53
+ npm install && npm run compile
54
+ # Press F5 in VS Code to launch Extension Development Host
55
+
56
+ # Install and compile sovereign-status
57
+ cd ../sovereign-status
58
+ npm install && npm run compile
59
+ ```
60
+
61
+ Requires a running [SnapKitty OS](https://collectivekitty.com) instance at `http://localhost:3000` (configurable via settings).
62
+
63
+ ---
64
+
65
+ ## MAGMA Protocol quick reference
66
+
67
+ ```
68
+ TIER PREFIXES $ SHORTHANDS
69
+ ๐Ÿ”’ SEAL CIPHER $seal โ€” cryptographic seal
70
+ ๐Ÿ“œ ANCHOR MNEMEX $anchor โ€” immutable WORM write
71
+ โšก FLUX HERALD $flux โ€” state transition / broadcast
72
+ ๐Ÿ‘ SENTINEL SENTINEL $watch โ€” security monitor (auto-urgent)
73
+ ๐Ÿฆ VAULT VAULT $vault โ€” financial authorization
74
+ ๐Ÿ”ฎ ORACLE ORACLE $query โ€” knowledge graph query
75
+ โš’๏ธ FORGE FORGE $forge โ€” build / deploy action
76
+ ๐Ÿง  NOVA NOVA $ask โ€” synthetic intelligence
77
+ ๐Ÿ’€ LOC LOC โ† binary outcome. no retry.
78
+ ```
79
+
80
+ ---
81
+
82
+ ## Settings
83
+
84
+ | Setting | Default | Description |
85
+ |---------|---------|-------------|
86
+ | `magma.osUrl` | `http://localhost:3000` | SnapKitty OS base URL |
87
+ | `magma.sealOnSave` | `false` | Auto-seal file hash on save |
88
+ | `magma.sealOnCommit` | `true` | Seal git commit hash to LEDGE |
89
+ | `magma.agentDefault` | `FORGE` | Default agent for instructions |
90
+ | `sovereignStatus.pollInterval` | `30` | Status bar poll interval (seconds) |
91
+
92
+ ---
93
+
94
+ ## Architecture
95
+
96
+ ```
97
+ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
98
+ โ”‚ VS Code โ”‚
99
+ โ”‚ magma-protocol extension ยท sovereign-status โ”‚
100
+ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
101
+ โ”‚
102
+ โ–ผ
103
+ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
104
+ โ”‚ SnapKitty OS (localhost:3000) โ”‚
105
+ โ”‚ /api/labs/ledge/seal ยท /api/merkle/root โ”‚
106
+ โ”‚ WORM chain ยท 24 agents ยท MAGMA ยท Merkle root โ”‚
107
+ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
108
+ ```
109
+
110
+ ---
111
+
112
+ ## Related
113
+
114
+ - [LEDGE](https://github.com/snapkittywest/ledge) โ€” open-source WORM chain (Rust + WASM)
115
+ - [SnapKitty OS](https://collectivekitty.com) โ€” the sovereign AI operating system
116
+ - [Live chain explorer](https://collectivekitty.com/labs/ledge)
117
+ - [Honeypot live feed](https://collectivekitty.com/labs/sentinel)
118
+
119
+ ---
120
+
121
+ *MIT License ยท SnapKitty Collective ยท 2026*
122
+ *"The development environment that seals every decision."*
123
+
124
+ ![](https://sovereign-analytics.snapkittywest.workers.dev/canary/sovereign-ide-extensions)
125
+
126
+ ---
127
+
128
+ ## License
129
+
130
+ Licensed under **Sovereign Source License**. Full text: [LICENSE](LICENSE).