Orbrey AI: Claude Code plugin

The Orbrey plugin for Claude Code gives you eleven skills, three agents, and seven commands that work with the household you authorise: recipes, pantry, grocery, calendar, and tasks. Ask Claude to plan a week of dinners, rotate chores fairly, or show what's on today, and it acts by calling Orbrey's API on your behalf.

This article covers the Claude Code plugin specifically. For connecting Claude Desktop, Claude.ai, or ChatGPT via MCP, see Using Orbrey with Claude (MCP).

Installation

In Claude Code, run these two commands in order:

/plugin marketplace add Orbrey-App/orbrey-skills
/plugin install orbrey@orbrey-ai-marketplace

Restart Claude Code after installation. The plugin bundles the Orbrey MCP server pointing at https://mcp.orbrey.com/, so no manual token paste is required.

If you installed the earlier orbrey-ai plugin, remove it first with /plugin uninstall orbrey-ai@orbrey-ai-marketplace, then run /plugin marketplace update orbrey-ai-marketplace before installing orbrey.

First-time authentication

The first time you run a skill or slash command, Claude Code will open a browser OAuth flow. Sign in to Orbrey, pick which household to authorise, and click Allow. Claude Code stores the access token securely (system keychain, or ~/.claude/.credentials.json as a fallback) and refreshes it automatically.

If you have already authorised Orbrey in Claude.ai's web settings, you will be asked to authorise once more in Claude Code because the two products use separate token stores. After the first flow, you will not be asked again.

Slash commands

Six one-liners for the most common household tasks, plus /orbrey:kitchen-concierge (see Skills). Each runs the matching skill with sensible defaults.

Skills

Skills are named capabilities you invoke with natural language or as arguments to a slash command. They always call the live MCP tools first, and nothing is invented.

• meal-planner: Draft a meal plan from your saved recipes and household context, and review the proposed grocery changes before they are written.
• grocery-organizer: Review the shared grocery list and propose duplicate merges; merging asks for confirmation.
• chore-rotator: Suggest a fair task rotation from your members and tasks.
• routine-builder: Build morning, school-prep, or bedtime routines as recurring tasks in morning, afternoon, evening, or anytime slots.
• calendar-conflict-finder: Flag calendar events that overlap.
• family-week-planner: One weekly view of meals, tasks, and calendar events.
• pantry-to-recipe: Match saved recipes to what is already in the pantry and show what is missing.
• household-onboarder: Check a household's setup and explain which steps to finish in the Orbrey app.
• recurring-task-author: Turn a schedule like “every other Tuesday” into a recurring task, and confirm before creating it.
• kitchen-concierge: Optional, Claude Code only. Prepares a grocery order in your own Chrome session; every checkout needs your decision.
• live-artifact-builder: Build interactive HTML artifacts from household details you provide or authorise.

Calling a skill

/orbrey:meal-planner plan 7 days, Maya dislikes fish
/orbrey:calendar-conflict-finder next 14 days
/orbrey:routine-builder bedtime routine for 6 year old

If a skill needs more context it will ask. All skills accept $ARGUMENTS for fast one-liner invocation.

Agents

Agents coordinate multiple skills and tool calls in sequence. They are designed for work that takes more than a single step.

• household-curator: Weekly review of stale tasks, expiring pantry items, uneven chore loads, unused recipes, and calendar overlaps. Run it on a Sunday evening to start the week clean.
• meal-plan-orchestrator: Coordinates meal planning with the pantry, grocery, and calendar tools. Invoked by the meal-planner skill when a plan needs more than one pass.
• routine-coach: Real-time helper for morning or bedtime routines. Ticks tasks done as steps are completed in conversation; any reward follows your household's task settings.

Safety hooks

The plugin ships three built-in hooks:

• confirm-destructive: Before any delete or merge, Claude Code surfaces a summary of what is about to change and waits for your confirmation.
• suggest-meal-slot: After a new recipe is created, suggests slotting it into the next open day in the meal plan.
• gate-order: Kitchen Concierge only. Blocks checkout unless the cart has passed verification, and still asks you before the purchase.

Orbrey in ChatGPT

ChatGPT uses a separate Orbrey plugin with the same Orbrey connection. It adds an Orbrey Home screen to ChatGPT's sidebar and leaves out the Claude Code commands, agents, hooks, and Kitchen Concierge. Every Orbrey connection, in either app, works only for households where every member is an adult account.

Plus-tier features

The pantry and meal-planning tools require an Orbrey Plus subscription on the authorised household. All other skills and commands work on the free plan.

Disconnecting

Uninstall the plugin in Claude Code with /plugin uninstall orbrey@orbrey-ai-marketplace, then disconnect the app from Settings, then Connected apps in the Orbrey app. Disconnecting it stops all further tool calls immediately.