Examples & Showcase

| [Project Name](https://github.com/your/project) | One-line description | `@your-handle` | MIT (or whatever) |

// packages/capability/openbuddy-counter/src/index.ts
import { Context, OpenBuddyService } from "@openbuddy/cordis";

export class CounterService extends OpenBuddyService {
  private count = 0;

  constructor(ctx: Context) {
    super(ctx, "openbuddy.capability.counter");
  }

  get value() { return this.count; }

  increment(by = 1) {
    this.count += by;
    this.ctx.emit("counter:changed", { value: this.count });
    return this.count;
  }
}

export default function apply(ctx: Context) {
  ctx.plugin(CounterService);
}

<!-- ~/.config/openbuddy/skills/greet.md -->
---
name: greet
description: Greet the user in their preferred language
triggers:
  - greet me
  - say hello
  - 打个招呼
---

# Greet

When the user says "greet me" or similar:

1. Look at their preferred language (Settings → Locale).
2. Respond with a culturally-appropriate greeting:

   - `en` → "Hello! How can I help you today?"
   - `zh-CN` → "你好!今天有什么可以帮你的?"
   - `ja` → "こんにちは!何をお手伝いしましょうか?"
   - `es` → "¡Hola! ¿En qué puedo ayudarte hoy?"

3. Offer a follow-up: "Want to start a new session, or pick up where you left off?"

// ~/.config/openbuddy/mcp.json
{
  "servers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp"],
      "env": {
        "TAVILY_API_KEY": "tvly-…"
      },
      "auth": "env"
    }
  }
}

<!-- ~/.config/openbuddy/experts/typescript-refactor.md -->
---
name: typescript-refactor
description: Expert in TypeScript refactoring
system_prompt: |
  You are an expert TypeScript refactorer.
  - Prefer readonly over mutability
  - Use Result types over throw
  - Maintain strict mode
  - Add tests with every refactor
---

# TypeScript Refactor Expert

When activated:
- Always check for existing tests before refactoring
- Prefer small, surgical changes
- Run `pnpm workspace:test` after each change
- Update CHANGELOG.md with breaking changes

import { automation, notification } from "@openbuddy/cordis";
import { WebClient } from "@slack/web-api";

const slack = new WebClient(process.env.SLACK_TOKEN);

automation.on("task:completed", async (task) => {
  if (task.duration > 5 * 60 * 1000) {
    await slack.chat.postMessage({
      channel: "#openbuddy",
      text: `✅ Task "${task.name}" finished in ${task.duration / 1000}s`,
    });
  }
});

import { Octokit } from "@octokit/rest";
import { agent } from "@openbuddy/agent";

const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });

agent.on("agent:error", async ({ sessionId, error }) => {
  if (error.severity === "critical") {
    await octokit.issues.create({
      owner: "your-org",
      repo: "your-repo",
      title: `OpenBuddy agent error in session ${sessionId}`,
      body: `\`\`\`\n${error.stack}\n\`\`\``,
      labels: ["bug", "openbuddy"],
    });
  }
});

import { Pool } from "pg";
import { agent } from "@openbuddy/agent";

const pool = new Pool({ connection:String: process.env.DATABASE_URL });

agent.on("agent:*", async (event) => {
  await pool.query(
    "INSERT INTO openbuddy_events (ts, session_id, type, payload) VALUES ($1, $2, $3, $4)",
    [new Date(), event.sessionId, event.type, JSON.stringify(event.payload)]
  );
});

| [项目名](https://github.com/your/project) | 一句话描述 | `@你的账号` | MIT(或其他) |