Orbeez kit
Agents & tools

Agent composer

<AgentComposer />
Makes an agent or changes one: its colour on a ring of beads, what it wears, a role to start from, its instructions, what each tool may do, the model, and how far a run may go.
Colour
Wears
Role
Tools
  • Search the webReads pages and cites them
  • Read the codebaseSearches and opens files
  • Write to the projectEdits files, runs migrations, posts
Model
Token budget per run
Most steps per run

Install

bash
npx shadcn@latest add https://orbeez-kit.vercel.app/r/agent-composer.json

Usage

tsx
<AgentComposer
  roles={[{ id: 'reviewer', label: 'Reviewer', instructions: 'Review diffs for...', tools: { shell: 'ask' }, accessory: 'goggles' }]}
  tools={[{ id: 'shell', label: 'Shell', hint: 'Run commands' }]}
  models={[{ id: 'fast', label: 'Fast' }, { id: 'deep', label: 'Deep' }]}
  onSubmit={(spec) => save(spec)}
  onCancel={close}
/>

Good to know

  • Picking a role fills in the instructions, the tools and what the agent wears; anything changed after that is kept.
  • Each tool is off, ask first, or free. 'ask' is the one to reach for: the agent stops at a Confirmation before using it.
  • The colour is a hue only, picked on a BeadOrbit, so whatever is picked reads in light and dark.
  • Pass initial to edit an agent rather than make one.