Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
OpenCode AI - AI-driven code editor/IDE (CLI/TUI version of Cursor/Windsurf). Use when: (1) AI-assisted coding tasks, (2) Code refactoring with AI, (3) GitHu...
OpenCode AI - AI-driven code editor/IDE (CLI/TUI version of Cursor/Windsurf). Use when: (1) AI-assisted coding tasks, (2) Code refactoring with AI, (3) GitHu...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
OpenCode is an AI-native code editor that runs in your terminal. Think of it as Cursor or Windsurf, but as a CLI/TUI tool. Version: 1.2.10 (Homebrew) Platform: macOS Darwin x64
CRITICAL: OpenCode requires sysctl to detect system architecture. Ensure /usr/sbin is in your PATH: export PATH="/usr/sbin:/usr/bin:/sbin:/bin:$PATH" If missing, OpenCode will fail with: Executable not found in $PATH: "sysctl" Add this to ~/.zshrc permanently: echo 'export PATH="/usr/sbin:/usr/bin:/sbin:/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
✅ Use for: Complex refactoring across multiple files AI-assisted feature implementation GitHub PR review and automated fixes Exploring and understanding unfamiliar codebases Running multi-step coding tasks with context Session-based coding (continue previous work) ❌ Don't use for: Simple one-line edits (use edit tool) Reading file contents (use read tool) Non-coding tasks
When running OpenCode in TUI mode (opencode), you can use these slash commands to control the AI workflow:
/sessions Opens session selector Choose to continue an existing session Create a new session (with user approval) Recommended: Select existing session for current project
/agents Available agents: plan - Planning mode (analyze and design) build - Build mode (implement and code) explore - Exploration mode (understand codebase) general - General assistance Best Practice: Always select plan first, then switch to build after approval.
/models Opens model selector Filter by provider (OpenAI, Anthropic, Google, Z.AI, etc.) Select preferred model for the task If authentication required, follow the login link provided
Plan Agent Behavior Ask OpenCode to analyze the task Request a clear step-by-step plan Allow OpenCode to ask clarification questions Review the plan carefully If plan is incomplete, ask for revision Do not allow code generation in Plan mode Build Agent Behavior Switch to Build using /agents Ask OpenCode to implement the approved plan If OpenCode asks questions, switch back to Plan Answer and confirm the plan, then switch back to Build Plan → Build Loop Select plan agent with /agents Describe the task Review and approve the plan Switch to build agent with /agents Implement the plan Repeat until satisfied Key Rules: Never skip Plan Never answer questions in Build mode (switch to Plan first) Always show slash commands explicitly in output
/title - Change session title /summary - Generate session summary /compaction - Compact conversation history
# Run a single AI command on a project opencode run "Add input validation to the login form" # With specific directory opencode run --dir ~/path/to/project "Refactor this code to use async/await" # With specific model opencode run -m openai/gpt-4o "Optimize the database queries" # Attach files for context opencode run -f src/auth.js -f src/database.js "Fix the authentication bug" # Continue last session opencode run --continue # Continue specific session opencode run --session abc123 --fork
# Start TUI in current directory opencode # Start TUI in specific project opencode ~/path/to/project # Start with specific model opencode -m anthropic/claude-sonnet-4
# List configured providers opencode auth list # Login to a provider (e.g., OpenCode, OpenAI, Anthropic) opencode auth login [url] # Logout opencode auth logout
# List all available models opencode models # List models for specific provider opencode models openai # List with cost metadata opencode models --verbose # Refresh model cache opencode models --refresh
# List all sessions opencode session list # Delete a session opencode session delete <sessionID> # Export session data opencode export [sessionID] # Import session from file opencode import <file>
# Fetch and checkout a PR, then run OpenCode opencode pr 123 # Manage GitHub agent opencode github --help
# List MCP servers opencode mcp list # Add an MCP server opencode mcp add # Authenticate with OAuth MCP server opencode mcp auth [name] # Debug OAuth connection opencode mcp debug <name>
# List all agents opencode agent list # Create a new agent opencode agent create
# Start headless server opencode serve # Start server and open web interface opencode web # Start ACP (Agent Client Protocol) server opencode acp
# Show token usage and costs opencode stats
OptionDescription-m, --modelModel to use (format: provider/model)-c, --continueContinue last session-s, --sessionContinue specific session--forkFork session when continuing--agentUse specific agent--dirDirectory to run in--formatOutput format: default or json--thinkingShow thinking blocks--variantModel reasoning effort (high, max, minimal)
opencode run "Refactor this function to be more readable and add error handling"
opencode run "Add a new API endpoint for user registration with email verification"
opencode run -f error.log -f src/auth.js "Fix the authentication bug described in the error log"
opencode run "Review this code for security vulnerabilities and suggest improvements"
# Auto-fix a PR opencode pr 123
# Continue last session opencode run --continue # Fork and continue (keeps original intact) opencode run --continue --fork
OpenCode maintains sessions that preserve context across runs: # Start a new session opencode run "Implement user authentication" # Continue it later opencode run --continue # Or continue a specific session opencode run --session session-abc123
Create: Run opencode run "prompt" or opencode Continue: Use --continue or --session <id> Fork: Use --fork to branch from a session Export: Save session data as JSON Delete: Remove old sessions
provider/model Examples: openai/gpt-4o anthropic/claude-sonnet-4 opencode/gpt-4o google/gemini-2.5-pro
# All models opencode models # Provider-specific opencode models openai opencode models anthropic
Some models support reasoning effort levels: opencode run --variant high "Solve this complex algorithm problem" opencode run --variant max "Architect a distributed system" opencode run --variant minimal "Quick code review"
Use --format json for machine-readable output: opencode run --format json "Refactor this code" | jq . Useful for: CI/CD integration Scripting Parsing results programmatically
For a GUI experience: # Start server + open browser opencode web # Custom port opencode web --port 8080 # Custom hostname opencode web --hostname 0.0.0.0
Problem: OpenCode can't find sysctl command Solution: export PATH="/usr/sbin:/usr/bin:/sbin:/bin:$PATH" Add to ~/.zshrc to make permanent.
Problem: OpenCode treats arguments as directory paths Solution: Use flags like --version, --help, or run explicitly: # Wrong opencode version # Right opencode --version
Problem: Interactive TUI waiting for input Solution: Press Ctrl+C to exit, or use run mode for non-interactive tasks.
Problem: Can't write to files Solution: Ensure file/directory permissions allow your user to write: chmod +w ./path/to/file
# For simple tasks bash command:"opencode run 'Add error handling'" # For longer tasks (background) bash background:true command:"opencode run 'Refactor entire codebase'"
bash command:"opencode session list"
bash command:"opencode stats"
Be specific: Clear prompts produce better results Use files: Attach relevant files with -f for context Iterate: Use --continue to build on previous work Fork experiments: Use --fork to try variations safely Choose models wisely: Different models excel at different tasks Monitor costs: Use opencode stats to track token usage Leverage sessions: Sessions maintain context across interactions
FeatureOpenCodeCursorWindsurfClaude CodeInterfaceCLI/TUIGUIGUICLITerminal-native✅❌❌✅Session management✅✅✅✅GitHub PR integration✅✅✅✅Model supportMultiMultiMultiAnthropicMCP support✅❌❌❌ Choose OpenCode when: You prefer terminal workflows Need CI/CD integration Want headless/server mode Require MCP protocol support
Version: opencode --version Help: opencode --help or opencode <command> --help Models: opencode models --verbose Sessions: opencode session list Last updated: 2026-02-25
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.