SDK
Examples
Common SDK usage examples.
Send a Chat Message
const response = await client.chat('Summarize the latest activity')
console.log(response)With options:
const response = await client.chat('Draft a project proposal', {
skill: 'proposal',
model: 'claude-sonnet-4-6',
})Read a Workspace File
const file = await client.workspace.read('memory/context.md')
console.log(file.content)Write a Workspace File
await client.workspace.write('notes/summary.md', '# Summary\n\nKey points...')List Workspace Files
const { files } = await client.workspace.list('notes/')
for (const file of files) {
console.log(file.path, file.type)
}List Skills
const { skills } = await client.skills.list()
for (const skill of skills) {
console.log(skill.name, skill.description)
}Call an MCP Tool
const result = await client.mcp.call('google-drive', 'search_drive', {
query: 'Q3 product brief',
})
console.log(result)Error Handling
import { CosmoClient, CosmoAPIError } from '@cosmohq/sdk'
try {
const response = await client.chat('Hello')
} catch (err) {
if (err instanceof CosmoAPIError) {
console.error(`API error ${err.status}: ${err.message}`)
}
}