Coordinate
Intelligence

import { agent, defineTool } from "@chorus/core";
import { gemini } from "@chorus/gemini";

"text-white/30">// Create a provider
const provider = gemini({ apiKey: process.env.GEMINI_API_KEY });

"text-white/30">// Define a tool
const searchTool = defineTool({
  name: "search",
  description: "Search the web for information",
  parameters: {
    type: "object",
    properties: {
      query: { type: "string", description: "Search query" }
    },
    required: ["query"]
  },
  execute: async ({ query }) => {
    "text-white/30">// Your search implementation
    return `Results for: ${query}`;
  }
});

"text-white/30">// Create your agent
const assistant = agent()
  .name("assistant")
  .systemPrompt("You are a helpful assistant.")
  .provider(provider)
  .tools([searchTool])
  .build();

"text-white/30">// Run it
const result = await assistant.run("What is the weather today?");
console.log(result.response);

import { agent, ensemble, conductor, createContext } from "@chorus/core";
import { gemini } from "@chorus/gemini";

const provider = gemini({ apiKey: process.env.GEMINI_API_KEY });

"text-white/30">// Create specialized agents
const researcher = agent()
  .name("researcher")
  .systemPrompt("You research topics thoroughly.")
  .provider(provider)
  .build();

const writer = agent()
  .name("writer")
  .systemPrompt("You write clear, engaging content.")
  .provider(provider)
  .build();

const reviewer = agent()
  .name("reviewer")
  .systemPrompt("You review and improve content quality.")
  .provider(provider)
  .build();

"text-white/30">// Create an ensemble
const team = ensemble()
  .name("content-team")
  .add(researcher, { role: "Research" })
  .add(writer, { role: "Write" })
  .add(reviewer, { role: "Review" })
  .build();

"text-white/30">// Create a sequential conductor
const seq = conductor()
  .strategy("sequential")
  .order(["researcher", "writer", "reviewer"])
  .build();

"text-white/30">// Run the ensemble
const result = await team.run("Write an article about AI agents", {
  conductor: seq,
  context: createContext(),
});

console.log(result.response);
console.log("Trace:", result.trace);

# Initialize a new Chorus project
$ chorus init my-agent-project
✓ Created my-agent-project/
✓ Installed dependencies
✓ Created agent.ts template

# Run an agent with execution tracing
$ chorus run agent.ts
[trace] Agent "assistant" started
[trace] Tool "search" called with { query: "weather" }
[trace] Response generated (245 tokens)
✓ Completed in 1.2s

# Launch the DevTools server
$ chorus devtools
✓ DevTools running at http://localhost:3333
  • View execution traces
  • Inspect agent state
  • Debug tool calls
  • Monitor token usage