opencode-dashi-plugin

An OpenCode plugin that provides access to a Dàshī (大师) — a grandmaster consultant for expert guidance.

What is Dashi?

Dashi enables a three-tier consultation pattern:

Dàshī (Grandmaster) ← Human ← Base Agent

The human can call upon the Dàshī for:

• Architectural review before implementation
• Analysis of complex or unfamiliar code
• Strategic guidance on critical decisions
• A second perspective on important changes

Features

• Auto-injects Dashi skill instructions on session creation
• Provides dashi tool for grandmaster consultation
• Agentic exploration — Dashi reads related files autonomously
• Model selection: sonnet (default) or opus for deepest analysis
• Read-only access — Dashi can explore but not modify your codebase
• Toast notification on completion

Prerequisites

Before using this plugin, ensure you have:

1. OpenCode installed — Get OpenCode
2. Claude Code CLI installed and authenticated — Claude Code
   • Run claude in your terminal to verify it's working
   • You'll need an active Anthropic subscription or API access

Installation

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-dashi-plugin"]
}

OpenCode will automatically install the plugin at startup.

Usage

Once installed, the plugin:

1. Injects skill instructions automatically when a new session is created
2. Provides the dashi tool for the user to invoke

User invocation: Type /dashi followed by your query:

/dashi review service.ts for security issues

The base agent will not invoke Dashi automatically — it waits for the user to request it.

Example Queries

| Query | Use case | |-------|----------| | /dashi review auth.ts for security vulnerabilities | Security audit | | /dashi is this architecture scalable? | Architectural guidance | | /dashi what's wrong with my error handling in api.ts? | Debugging assistance | | /dashi suggest improvements for the test coverage | Code quality review | | /dashi compare these two implementation approaches | Decision support |

Tool Arguments

The dashi tool supports optional arguments:

| Argument | Description | Default | |----------|-------------|---------| | model | sonnet or opus (deeper analysis) | sonnet | | context | Additional context to provide | — |

Example with arguments:

/dashi review this refactoring plan (use opus for deeper analysis)

The base agent will pass model: "opus" to the tool.

Troubleshooting

"Claude Code CLI not found"

Ensure Claude Code is installed:

claude --version

If not installed, follow the Claude Code setup guide.

"Error consulting Dàshī: authentication failed"

Your Claude Code session may not be authenticated. Run:

claude

and complete the login flow.

Dashi doesn't explore related files

Dashi is instructed to explore autonomously, but if you're piping in context explicitly, it may rely on what you provide. Try calling /dashi without pre-reading files — let Dashi discover them.

Development

Build

npm run build

Local Testing

To test locally before publishing, reference it directly in your project:

{
  "plugin": ["./path/to/project-dashi"]
}

Or use npm link:

# In this directory
npm link

# In your project
npm link opencode-dashi-plugin

Publishing

npm run build
npm publish

Structure

project-dashi/
├── src/
│   ├── index.ts           # Plugin entry point
│   ├── skill-content.ts   # Skill instructions
│   └── tools/
│       └── dashi.ts       # Dashi tool
├── dist/                  # Built output
├── package.json
├── tsconfig.json
└── README.md

License

MIT