rstacruz

#!/usr/bin/env bash
# Prints a random name.
#
# Usage:
#   echo $(gen-name)
#   # oceanwood
#   # raincloud
#   # mahoganybay
#   # scarletfog

rstacruz

Opencode plugin development guide

Generated with LLM assistance on 2 Nov 2025 with minimal human verification.

Overview

Opencode plugins extend the functionality of the Opencode AI assistant by allowing you to add custom tools, authentication providers, event handlers, and hooks into the core system. This guide covers how to create, configure, and distribute plugins.

Source files:

rstacruz

Keeping up with a changelog

Got a fast-moving changelog like in https://github.com/sst/opencode/releases ? OpenCode itself can help you keep track.

1. Add this file

   • Add opencode_changes.md below into your Notes and snippets git repo
   • You have a notes repo, don't you? If not, start a repo where you dump random Markdown files. It's useful for a lot of things

2. Ask OpenCode to update it

rstacruz

Copy file path to clipboard

Here's a simple way to integrate Neovim with OpenCode or Claude Code.

1. Select some text
2. Press <leader>fyr
3. Paste it into the LLM agent of your choice

This copies the file path into your clipboard in a format like @lib/keymaps.lua#L24-36. This mimics what the Claude Code VS Code extension would do (Alt+Cmd+K).

rstacruz

One-step quick commit

Commit and push in one step with opencode.

$ oc-commit
.
.

feat(bin): update help formatting and clarify LLM agent usage

rstacruz

OpenCode notification plugin

Shows desktop notifications with a summary of what the agent last said:

• Place AGENTS.md in ~/.config/opencode/AGENTS.md
• Place notification.ts in ~/.config/opencode/plugin/notification.ts

rstacruz

Also check out https://github.com/rstacruz/spec-mode-prompt

rstacruz

Spec mode guidelines

You are a senior software engineer assisting a user in defining and planning a new feature. Your goal is to guide the user through a structured process, resulting in a clear set of documents that can be handed off for implementation.

Guiding principles

• Planner, not doer:
  • Your primary role is to create planning artifacts (requirements.md, design.md, tasks.md).
  • You MUST NOT write the implementation code yourself.
• Phased approach:

rstacruz

Stop letting Aider code blindly - try this first

Using Aider's /ask and /architect commands to approach larger tasks.

Aider is one of the best AI coding tools available today (in my opinion!). It's a brilliant AI coding assistant that integrates with any LLM, in any code editor.

However, Aider can often feel very eager to make changes. It jumps right into coding after I type anything. I noticed a pattern:

• I would describe what I wanted
• Aider would start coding right away

rstacruz

Test storybook stories in Vitest + React testing library

Let's say you have these files:

• Chat.tsx
• Chat.stories.tsx
• Chat.test.tsx

The test file can be written to use Storybook stories: