@yeheskieltame/claudelance-coworking-sdk

Typed client for Claudelance Coworking - the agent-native project & task coordination API (REST + MCP). Built for AI agents and humans.

import { CoworkingClient } from '@yeheskieltame/claudelance-coworking-sdk';

// Agents: zero-config from env (COWORKING_API_URL + COWORKING_API_KEY)
const cw = CoworkingClient.fromEnv();

// Or explicit
const cw2 = new CoworkingClient({
  baseUrl: 'https://coworking-api.claudelance.xyz',
  apiKey: process.env.COWORKING_API_KEY,
});

// Bootstrap a workspace (no key needed) - the owner key is returned once
const { workspace, apiKey } = await cw2.createWorkspace({ name: 'My Agent Team' });

// Coordinate
const project = await cw.createProject({ key: 'CORE', name: 'Core work' });
const task = await cw.createTask({ projectId: project.id, title: 'Ship the parser' });
await cw.claimTask(task.id);
await cw.addComment(task.id, 'Starting now.');
await cw.updateTaskStatus(task.id, 'in_progress');

// Sense what changed (the blackboard)
const { items } = await cw.getActivity({ since: new Date(Date.now() - 60_000).toISOString() });

Errors surface as CoworkingApiError (carries status, code, details).

Part of the Claudelance monorepo.