@samirosamsam/aim 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/.codex-plugin/plugin.json +5 -2
- package/README.md +19 -1
- package/assets/rippletide-logo.png +0 -0
- package/package.json +2 -1
- package/skills/aim/SKILL.md +4 -2
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aim",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "Install deterministic Codex guardrails from natural-language block rules.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "AIM"
|
|
@@ -13,9 +13,12 @@
|
|
|
13
13
|
"displayName": "AIM",
|
|
14
14
|
"shortDescription": "Block matching Codex tool calls with local guardrails.",
|
|
15
15
|
"longDescription": "AIM helps Codex turn natural-language block requests into local PreToolUse guardrails for Bash, file edits, and MCP tool calls.",
|
|
16
|
-
"developerName": "
|
|
16
|
+
"developerName": "Rippletide",
|
|
17
17
|
"category": "Productivity",
|
|
18
18
|
"capabilities": ["Write"],
|
|
19
|
+
"brandColor": "#272757",
|
|
20
|
+
"composerIcon": "assets/rippletide-logo.png",
|
|
21
|
+
"logo": "assets/rippletide-logo.png",
|
|
19
22
|
"defaultPrompt": [
|
|
20
23
|
"Block this Codex action.",
|
|
21
24
|
"Install deterministic guardrails for this repo."
|
package/README.md
CHANGED
|
@@ -26,7 +26,22 @@ codex plugin marketplace add tototozip/AIM --ref main
|
|
|
26
26
|
codex plugin add aim@aim
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
Then start a new Codex thread
|
|
29
|
+
Then start a new Codex thread, run `/hooks`, trust the AIM hook if Codex asks,
|
|
30
|
+
and invoke `@aim`.
|
|
31
|
+
|
|
32
|
+
Example:
|
|
33
|
+
|
|
34
|
+
```text
|
|
35
|
+
@aim empêche git push
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
To test it, ask Codex to run:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
git push origin main --dry-run
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
The call should be denied before Bash executes.
|
|
30
45
|
|
|
31
46
|
## Codex Guardrail
|
|
32
47
|
|
|
@@ -36,6 +51,9 @@ Install or refresh the local Codex hook:
|
|
|
36
51
|
npx -y @samirosamsam/aim@latest setup
|
|
37
52
|
```
|
|
38
53
|
|
|
54
|
+
This is only needed when using the CLI without the Codex plugin. The plugin
|
|
55
|
+
already bundles `hooks/hooks.json`.
|
|
56
|
+
|
|
39
57
|
If Codex says hooks need review, run `/hooks`, inspect the AIM hook, and trust it.
|
|
40
58
|
|
|
41
59
|
Add a deterministic guardrail from natural language:
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@samirosamsam/aim",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "AIM CLI for installing deterministic Codex tool-call guardrails.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
"files": [
|
|
11
11
|
".agents/plugins/marketplace.json",
|
|
12
12
|
".codex-plugin/plugin.json",
|
|
13
|
+
"assets/",
|
|
13
14
|
"bin/",
|
|
14
15
|
"hooks/",
|
|
15
16
|
"skills/",
|
package/skills/aim/SKILL.md
CHANGED
|
@@ -9,13 +9,15 @@ Use the public `aim` CLI as the source of truth for installing Codex hooks, addi
|
|
|
9
9
|
|
|
10
10
|
## Workflow
|
|
11
11
|
|
|
12
|
-
1.
|
|
12
|
+
1. Use the bundled plugin hook when AIM is installed as a Codex plugin. Do not run `setup` just to duplicate it. If Codex reports hooks need review, tell the user to run `/hooks`, inspect the AIM hook, and trust it.
|
|
13
|
+
|
|
14
|
+
For CLI-only use without the Codex plugin, install or refresh the Codex `PreToolUse` hook before claiming enforcement is active:
|
|
13
15
|
|
|
14
16
|
```bash
|
|
15
17
|
npx -y @samirosamsam/aim@latest setup --json
|
|
16
18
|
```
|
|
17
19
|
|
|
18
|
-
|
|
20
|
+
Do not claim active enforcement until the hook is trusted and a proof call blocks.
|
|
19
21
|
|
|
20
22
|
2. Choose the smallest enforceable path:
|
|
21
23
|
|