Cosmo Docs
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}`)
  }
}