You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Apr 19, 2026. It is now read-only.
<imgsrc="https://github.com/user-attachments/assets/a94a8a5e-dfeb-4771-a6ab-465d3c2f01f0"alt="ShellForge β Local Governed Agent Runtime"width="700">
17
16
@@ -24,11 +23,11 @@
24
23
### 1. Install ShellForge
25
24
26
25
```bash
27
-
brew tap AgentGuardHQ/tap
26
+
brew tap chitinhq/tap
28
27
brew install shellforge
29
28
```
30
29
31
-
Or from source: `git clone https://github.com/AgentGuardHQ/shellforge.git && cd shellforge && go build -o shellforge ./cmd/shellforge/`
30
+
Or from source: `git clone https://github.com/chitinhq/shellforge.git && cd shellforge && go build -o shellforge ./cmd/shellforge/`
32
31
33
32
### 2. Install Ollama (if you haven't already)
34
33
@@ -82,12 +81,12 @@ Two modes:
82
81
1.**Interactive REPL** (`shellforge chat`) β pair-program with a local or cloud model. Persistent conversation history, shell escapes, color output.
83
82
2.**Autonomous agents** (`shellforge agent`, `shellforge ralph`) β one-shot tasks or multi-task loops with automatic validation and commit.
84
83
85
-
Both modes share the same governance layer. Every tool call passes through [AgentGuard](https://github.com/AgentGuardHQ/agentguard) policy enforcement before execution.
84
+
Both modes share the same governance layer. Every tool call passes through [Chitin](https://github.com/chitinhq/chitin) policy enforcement before execution.
@@ -134,16 +133,16 @@ Tasks come from a JSON file or Octi Pulpo MCP dispatch. Failed validations skip
134
133
|**Infer**|[Ollama](https://ollama.com)| Local LLM inference (Metal GPU on Mac) |
135
134
|**Optimize**|[RTK](https://github.com/rtk-ai/rtk)| Token compression β 70-90% reduction on shell output |
136
135
|**Execute**|[Goose](https://block.github.io/goose)| AI coding agent with native Ollama support (headless) |
137
-
|**Coordinate**|[Octi Pulpo](https://github.com/AgentGuardHQ/octi-pulpo)| Budget-aware dispatch, episodic memory, model cascading |
138
-
|**Govern**|[AgentGuard](https://github.com/AgentGuardHQ/agentguard)| Policy enforcement on every action β allow/deny/correct |
136
+
|**Coordinate**|[Octi Pulpo](https://github.com/chitinhq/octi)| Budget-aware dispatch, episodic memory, model cascading |
137
+
|**Govern**|[Chitin](https://github.com/chitinhq/chitin)| Policy enforcement on every action β allow/deny/correct |
139
138
|**Sandbox**|[OpenShell](https://github.com/NVIDIA/OpenShell)| Kernel-level isolation (Docker on macOS) |
140
139
|**Scan**|[DefenseClaw](https://github.com/cisco-ai-defense/defenseclaw)| Supply chain scanner β AI Bill of Materials |
141
140
142
141
```bash
143
142
shellforge status
144
143
# Ollama running (qwen3:30b loaded)
145
144
# RTK v0.4.2
146
-
#AgentGuard enforce mode (5 rules)
145
+
#Chitin enforce mode (5 rules)
147
146
# Octi Pulpo connected (http://localhost:8080)
148
147
# OpenShell Docker sandbox active
149
148
# DefenseClaw scanner ready
@@ -193,7 +192,7 @@ The agent loop (used by `chat`, `agent`, and `ralph`) has 8 built-in tools, all
193
192
194
193
## Multi-Driver Governance
195
194
196
-
ShellForge governs any CLI agent driver via AgentGuard hooks. Each driver keeps its own model and agent loop β ShellForge ensures governance is active and spawns the driver as a subprocess.
195
+
ShellForge governs any CLI agent driver via Chitin hooks. Each driver keeps its own model and agent loop β ShellForge ensures governance is active and spawns the driver as a subprocess.
197
196
198
197
```bash
199
198
# Run any driver with governance
@@ -235,7 +234,7 @@ See `dags/multi-driver-swarm.yaml` and `dags/workspace-swarm.yaml` for examples.
-[x] Migrated to API-driven dispatch: Octi Pulpo β ShellForge β Anthropic API
@@ -147,13 +146,13 @@ Bugs identified during v0.6.x development. Fix before v1.0.
147
146
148
147
| Issue | Package | Severity | Description |
149
148
|-------|---------|----------|-------------|
150
-
|[#69](https://github.com/AgentGuardHQ/shellforge/issues/69)|`agentguard.yaml`| High | Governance gap: plain `rm` and `rm -r` bypass `no-destructive-rm` policy |
151
-
|[#67](https://github.com/AgentGuardHQ/shellforge/issues/67)|`scripts/govern-shell.sh`| Medium | Fragile `sed`-based JSON parsing β denial reason extraction can fail or corrupt |
152
-
|[#65](https://github.com/AgentGuardHQ/shellforge/issues/65)|`internal/scheduler`| Medium |`os.WriteFile` error silently ignored β audit log loss |
153
-
|[#63](https://github.com/AgentGuardHQ/shellforge/issues/63)|`internal/normalizer`| Medium |`classifyShellRisk` prefix match too broad β `catalog_tool` classified as read-only |
154
-
|[#62](https://github.com/AgentGuardHQ/shellforge/issues/62)|`cmd/shellforge`| Medium |`cmdEvaluate` ignores JSON unmarshal error β malformed input defaults to allow |
155
-
|[#61](https://github.com/AgentGuardHQ/shellforge/issues/61)|`internal/intent`| Low | Dead code in `flattenParams` β first assignment immediately overwritten |
156
-
|[#60](https://github.com/AgentGuardHQ/shellforge/issues/60)| all packages | High | Zero test coverage β critical for a governance runtime |
149
+
|[#69](https://github.com/chitinhq/shellforge/issues/69)|`agentguard.yaml`| High | Governance gap: plain `rm` and `rm -r` bypass `no-destructive-rm` policy |
150
+
|[#67](https://github.com/chitinhq/shellforge/issues/67)|`scripts/govern-shell.sh`| Medium | Fragile `sed`-based JSON parsing β denial reason extraction can fail or corrupt |
151
+
|[#65](https://github.com/chitinhq/shellforge/issues/65)|`internal/scheduler`| Medium |`os.WriteFile` error silently ignored β audit log loss |
152
+
|[#63](https://github.com/chitinhq/shellforge/issues/63)|`internal/normalizer`| Medium |`classifyShellRisk` prefix match too broad β `catalog_tool` classified as read-only |
153
+
|[#62](https://github.com/chitinhq/shellforge/issues/62)|`cmd/shellforge`| Medium |`cmdEvaluate` ignores JSON unmarshal error β malformed input defaults to allow |
154
+
|[#61](https://github.com/chitinhq/shellforge/issues/61)|`internal/intent`| Low | Dead code in `flattenParams` β first assignment immediately overwritten |
155
+
|[#60](https://github.com/chitinhq/shellforge/issues/60)| all packages | High | Zero test coverage β critical for a governance runtime |
0 commit comments