Skip to content

Commit 23bdf79

Browse files
thrashr888claude
thrashr888
and
claude
committed
feat: add agent plugins for OpenCode, Codex, Gemini CLI, and MCP
- OpenCode plugin with session lifecycle hooks and sandbox tools (sandbox_run, sandbox_exec, sandbox_list) - Codex MCP server config - Gemini CLI MCP server config - Universal MCP guide for any compatible agent Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 2f27c72 commit 23bdf79

10 files changed

Lines changed: 468 additions & 4 deletions

File tree

‎.beads/issues.jsonl‎

Lines changed: 4 additions & 4 deletions
Large diffs are not rendered by default.

‎plugins/codex/README.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# agentkernel for Codex
2+
3+
Use agentkernel as a sandbox backend for OpenAI Codex via MCP.
4+
5+
## Setup
6+
7+
1. Install agentkernel:
8+
9+
```bash
10+
brew tap thrashr888/agentkernel && brew install agentkernel
11+
```
12+
13+
2. Add the MCP server config to your Codex setup. Copy `mcp.json` to your Codex MCP configuration directory:
14+
15+
```json
16+
{
17+
"mcpServers": {
18+
"agentkernel": {
19+
"command": "agentkernel",
20+
"args": ["mcp-server"],
21+
"env": {}
22+
}
23+
}
24+
}
25+
```
26+
27+
3. Start using agentkernel tools in Codex. The MCP server exposes:
28+
29+
| Tool | Description |
30+
|------|-------------|
31+
| `run_command` | Run a command in a temporary sandbox |
32+
| `create_sandbox` | Create a persistent sandbox |
33+
| `exec_in_sandbox` | Execute in an existing sandbox |
34+
| `remove_sandbox` | Remove a sandbox |
35+
| `list_sandboxes` | List all sandboxes |
36+
37+
## How It Works
38+
39+
The `agentkernel mcp-server` command starts a stdio-based MCP server that Codex connects to. All code execution is routed through agentkernel's microVM sandboxes.
40+
41+
## License
42+
43+
MIT

‎plugins/codex/mcp.json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"mcpServers": {
3+
"agentkernel": {
4+
"command": "agentkernel",
5+
"args": ["mcp-server"],
6+
"env": {}
7+
}
8+
}
9+
}

‎plugins/gemini/README.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# agentkernel for Gemini CLI
2+
3+
Use agentkernel as a sandbox backend for Google Gemini CLI via MCP.
4+
5+
## Setup
6+
7+
1. Install agentkernel:
8+
9+
```bash
10+
brew tap thrashr888/agentkernel && brew install agentkernel
11+
```
12+
13+
2. Add the MCP server to your Gemini CLI config. Add to your `~/.gemini/settings.json` or project-level `.gemini/settings.json`:
14+
15+
```json
16+
{
17+
"mcpServers": {
18+
"agentkernel": {
19+
"command": "agentkernel",
20+
"args": ["mcp-server"],
21+
"env": {}
22+
}
23+
}
24+
}
25+
```
26+
27+
3. Start using agentkernel tools in Gemini CLI. The MCP server exposes:
28+
29+
| Tool | Description |
30+
|------|-------------|
31+
| `run_command` | Run a command in a temporary sandbox |
32+
| `create_sandbox` | Create a persistent sandbox |
33+
| `exec_in_sandbox` | Execute in an existing sandbox |
34+
| `remove_sandbox` | Remove a sandbox |
35+
| `list_sandboxes` | List all sandboxes |
36+
37+
## How It Works
38+
39+
The `agentkernel mcp-server` command starts a stdio-based MCP server that Gemini CLI connects to. All code execution is routed through agentkernel's microVM sandboxes.
40+
41+
## License
42+
43+
MIT

‎plugins/gemini/mcp.json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"mcpServers": {
3+
"agentkernel": {
4+
"command": "agentkernel",
5+
"args": ["mcp-server"],
6+
"env": {}
7+
}
8+
}
9+
}

‎plugins/mcp/README.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# agentkernel MCP Server
2+
3+
Use agentkernel with any MCP-compatible AI coding agent.
4+
5+
agentkernel includes a built-in MCP (Model Context Protocol) server that lets any compatible agent run commands in hardware-isolated microVM sandboxes.
6+
7+
## Compatible Agents
8+
9+
| Agent | Config Location | Status |
10+
|-------|----------------|--------|
11+
| Claude Code | `~/.claude/settings.json` | Built-in (see `claude-plugin/`) |
12+
| Codex | MCP config file | See `plugins/codex/` |
13+
| Gemini CLI | `~/.gemini/settings.json` | See `plugins/gemini/` |
14+
| OpenCode | `.opencode/plugins/` | See `plugins/opencode/` |
15+
| Any MCP agent | Varies | Use config below |
16+
17+
## Universal MCP Config
18+
19+
For any MCP-compatible agent, add this server configuration:
20+
21+
```json
22+
{
23+
"mcpServers": {
24+
"agentkernel": {
25+
"command": "agentkernel",
26+
"args": ["mcp-server"],
27+
"env": {}
28+
}
29+
}
30+
}
31+
```
32+
33+
With an API key:
34+
35+
```json
36+
{
37+
"mcpServers": {
38+
"agentkernel": {
39+
"command": "agentkernel",
40+
"args": ["mcp-server"],
41+
"env": {
42+
"AGENTKERNEL_API_KEY": "sk-..."
43+
}
44+
}
45+
}
46+
}
47+
```
48+
49+
## MCP Tools
50+
51+
The server exposes these tools:
52+
53+
| Tool | Description |
54+
|------|-------------|
55+
| `run_command` | Run a command in a temporary sandbox |
56+
| `create_sandbox` | Create a named persistent sandbox |
57+
| `exec_in_sandbox` | Execute a command in an existing sandbox |
58+
| `remove_sandbox` | Remove a sandbox |
59+
| `list_sandboxes` | List all active sandboxes |
60+
61+
## Prerequisites
62+
63+
Install agentkernel:
64+
65+
```bash
66+
# Homebrew
67+
brew tap thrashr888/agentkernel && brew install agentkernel
68+
69+
# Cargo
70+
cargo install --git https://github.com/thrashr888/agentkernel
71+
72+
# From source
73+
git clone https://github.com/thrashr888/agentkernel
74+
cd agentkernel && cargo build --release
75+
```
76+
77+
## License
78+
79+
MIT

‎plugins/mcp/mcp.json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"mcpServers": {
3+
"agentkernel": {
4+
"command": "agentkernel",
5+
"args": ["mcp-server"],
6+
"env": {}
7+
}
8+
}
9+
}

‎plugins/opencode/.opencode/package.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"dependencies": {
3+
"@opencode-ai/plugin": "latest"
4+
}
5+
}

0 commit comments

Comments
 (0)