Build Your Own OpenCode

import hud
from hud.agents import create_agent
from hud.tools.coding import EditTool, ShellTool
from hud.tools.filesystem import ReadTool, GrepTool, GlobTool, ListTool

# Create environment with all OpenCode tools
env = hud.Environment("my-opencode")
base = "./workspace"

# Coding tools
env.add_tool(ShellTool())
env.add_tool(EditTool())

# Filesystem exploration tools
env.add_tool(ReadTool(base_path=base))
env.add_tool(GrepTool(base_path=base))
env.add_tool(GlobTool(base_path=base))
env.add_tool(ListTool(base_path=base))

# Define scenario for evaluation
@env.scenario("coding_task")
async def coding_task(task: str):
    yield f"""You are a skilled software developer. Complete the following task:

{task}

Available tools:
- `shell` - Run bash commands
- `str_replace_based_edit_tool` - Edit files using str_replace
- `read` - Read file contents with line numbers
- `grep` - Search file contents with regex
- `glob` - Find files by pattern
- `list` - List directory contents

Explore the codebase first using read/grep/glob/list, then make changes."""
    yield 1.0

# Run with any model
agent = create_agent("gpt-4o")

async with hud.eval(env("coding_task", task="Fix the bug in main.py"), name="opencode-local") as ctx:
    await agent.run(ctx, max_steps=30)

import hud
from hud.agents import create_agent
from hud.tools.filesystem import ReadTool, GrepTool, GlobTool, ListTool

env = hud.Environment("opencode-plan")
base = "./workspace"

# Only read-only tools - no edit or shell
env.add_tool(ReadTool(base_path=base))
env.add_tool(GrepTool(base_path=base))
env.add_tool(GlobTool(base_path=base))
env.add_tool(ListTool(base_path=base))

@env.scenario("analyze")
async def analyze_task(question: str):
    yield f"""You are analyzing a codebase. Answer this question:

{question}

Use the available read-only tools to explore. Do NOT suggest code changes."""
    yield 1.0

agent = create_agent("claude-sonnet-4-5")

async with hud.eval(env("analyze", question="How does auth work?"), name="opencode-plan") as ctx:
    await agent.run(ctx, max_steps=20)

{
    "command": "str_replace",
    "path": "src/main.py",
    "old_str": "def hello():\n    print('Hello')",
    "new_str": "def hello():\n    print('Hello, World!')"
}

# Build mode - make changes to code
uv run python examples/07_opencode_agent.py --task "Add error handling to api.py"

# Plan mode (read-only exploration)
uv run python examples/07_opencode_agent.py --plan --task "How does the auth system work?"

# Use different models
uv run python examples/07_opencode_agent.py --model gpt-4o --task "Fix the bug"
uv run python examples/07_opencode_agent.py --model claude-sonnet-4-5 --task "Add tests"

# Verbose output
uv run python examples/07_opencode_agent.py --verbose --task "Refactor utils"