convez.ai
AgenteAutomaçãoIntermediário
zosmaai

Zosma Cowork

zosmaai/zosma-cowork

Desktop para agentes de IA — alternativa open-source ao Claude Cowork

Ver no GitHub
BomPluginScore · de 0 a 100

Interface gráfica de desktop para executar agentes de IA (baseado no pi coding agent), permitindo automação de tarefas com streaming, pensamento do modelo e chamadas de ferramentas — totalmente open-source e funciona localmente. Compatível com Claude, ChatGPT, Copilot e modelos locais.

Instalação

$npx convez-ai zosmaai/zosma-cowork

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
120
Forks
18
Acompanhando
4
Saúde
87%
Último commit
há 1 mês
Versão
v0.18.0
Issues abertas
1
Contribuidores
4

Casos de uso

  • Automação de workflows sem código via linguagem natural
  • Processamento de documentos e dados com agentes IA
  • Prototipagem rápida de soluções agentic localmente

Veredito

Ferramenta robusta e bem construída para quem quer agentes IA desktop sem dependências cloud. A arquitetura modular via pi ecosystem é um diferencial, mas requer familiaridade com extensões e configuração local.

README

A tradução para o português deste README ainda está na fila.

Zosma Cowork 🇮🇳

English | 中文 | Español | 日本語 | Deutsch | Français | Português | Русский | 한국어 | हिंदी

CI Release License: MIT Platforms Built with Tauri Discord GitHub Repo Stars

A desktop agentic work harness built on pi, the minimal, language-agnostic coding agent harness. Streaming, thinking, tool calls, multi-turn sessions — all free, all open-source, all local.

Built by Zosma AI.

Gallery

Invoice processing with natural language agents. See more demos at zosma.ai/zosma-cowork/gallery

Why Zosma Cowork?

🌟 Built on pi

Zosma Cowork is a desktop application built on pi — the minimal, language-agnostic coding agent harness. pi's philosophy of simplicity and composability carries directly into your desktop experience. Every pi extension works out of the box, with zero wrappers or adapters.

🆓 Free & Open Source

Zosma Cowork is 100% free and open-source (MIT). Bring your own API key, use an existing subscription (Claude, ChatGPT, Copilot), or run local models — you stay in control.

🧩 Full pi Extension Ecosystem

The pi ecosystem includes hundreds of extensions, skills, tools, prompts, and themes — all compatible with Zosma Cowork. Plug them into your ~/.zosmaai/cowork/ directory and they just work. No wrapping, no porting, no lock-in.

Features

  • Node.js agent sidecar — The pi-mono TypeScript SDK runs in a managed sidecar process for full agent capabilities (extensions, tools, providers)
  • Thin Tauri relay — The Rust layer is a minimal IPC bridge between React and the sidecar, keeping the native desktop shell lightweight
  • pi extension ecosystem — Compatible with pi extensions via DefaultResourceLoader — skills, tools, and prompts auto-discovered from ~/.zosmaai/cowork/
  • Multi-turn sessions — Full conversation continuity with persistent session history
  • Streaming responses — See the agent think, write, and call tools in real-time
  • Thinking blocks — Expandable reasoning from the model
  • Tool call timeline — Live bash/edit/write tool calls with args and results
  • Session management — Persistent chat sessions saved to ~/.zosmaai/cowork/
  • Light & dark mode — Warm cream light mode, warm charcoal dark mode
  • Keyboard shortcuts — Cmd/Ctrl+Shift+K to focus, Cmd/Ctrl+N for new session
  • Abort & steering — Stop a running agent mid-turn, send follow-up steering messages
  • Claude-inspired UI — 3-column layout with sidebar, workspace, and info panel

Architecture

The diagram is generated from assets/architecture.mmd. To update:

# Edit assets/architecture.mmd, then re-render:
mmdc -i assets/architecture.mmd -o assets/architecture.png -b white -w 900 -H 700

Tech Stack

LayerTechnology
FrontendReact 19, Tailwind CSS v4, Radix UI
Desktop ShellTauri v2, Rust, Tokio
Agent EngineNode.js sidecar using @earendil-works/pi-coding-agent (pi-mono SDK)
TestingVitest, Testing Library, jsdom
LintingBiome (frontend + sidecar), Clippy (Tauri relay)

Development

Prerequisites

Quick Start

# Install frontend dependencies
npm install

# Install agent-sidecar dependencies
cd agent-sidecar && npm install && cd ..

# Run frontend dev server
npm run dev:frontend

# Run full Tauri app (frontend + Rust relay + Node.js sidecar)
npm run dev

npm run dev runs the sidecar from TypeScript source via tsx — no bundle needed. On a fresh checkout it auto-generates lightweight dev stubs for the Tauri bundle resources (src-tauri/agent-sidecar/index.cjs, src-tauri/binaries/node) so the Rust shell can compile. The real sidecar bundle and Node.js binary are produced only by the production build (npm run build).

Scripts

# Frontend
npm run lint          # Biome lint
npm run typecheck     # TypeScript check
npm run test          # Vitest run
npm run validate      # lint + typecheck + test
npm run format        # Biome format

# Tauri
npm run build:frontend
npm run build         # Build release binary

# Agent Sidecar
cd agent-sidecar
npm run build         # TypeScript → JavaScript
npm run dev           # tsx watch (standalone development)

# Rust (Tauri relay only)
cargo fmt --all --check
cargo clippy --workspace -- -D warnings

Staging builds

Every merge to main produces unsigned cross-platform installers via the Staging Build workflow (.github/workflows/staging-build.yml). The bundles are attached as workflow artifacts (14-day retention) and a Discord embed with auth-free nightly.link download URLs is posted to whatever channel the DISCORD_STAGING_WEBHOOK repo secret points at (typically #staging-builds).

This flow does not create a GitHub Release, tag a commit, or publish to AUR / winget / Homebrew — those side-effects remain gated on the tag-triggered release.yml. See issue #133 for the design.

To run a staging build on demand, trigger Staging Build from the Actions tab via Run workflow.

One-time setup: in Discord, open the target channel → Edit Channel → Integrations → Webhooks → New Webhook, copy the URL, then add it as a GitHub repo secret named DISCORD_STAGING_WEBHOOK (Settings → Secrets and variables → Actions → New repository secret). The workflow degrades gracefully — if the secret is unset the notify job emits a warning and exits 0, so the build itself still succeeds and the artifacts are still uploaded.

Config & Data

WhatLocationNotes
LLM providers & API keys~/.zosmaai/cowork/auth.jsonManaged by the app
Model definitions~/.zosmaai/cowork/models.jsonManaged by the app
Extensions & skills~/.zosmaai/cowork/extensions/Pi-compatible extensions
Session history~/.zosmaai/cowork/Managed by Zosma Cowork

IPC Protocol

The Tauri relay communicates with the Node.js sidecar via stdin/stdout JSON lines:

Commands (→ sidecar):

CommandDescription
initInitialize agent with zosmaDir config
get_modelsList available models from all providers
promptSend user message, stream events
abortCancel running prompt
set_modelSwitch active model
save_authSave API key for a provider
reloadReinitialize with fresh extensions/auth

Events (← sidecar):

EventUI Effect
readyModels loaded, enable UI
eventAgent session events (thinking, text, tool calls)
donePrompt completed
resultResponse to a request command
errorError with message

Project Structure

zosma-cowork/
├── agent-sidecar/                # Node.js agent process
│   └── src/
│       └── index.ts              # Sidecar: pi-mono SDK, stdin/stdout protocol
├── src/                          # React frontend
│   ├── components/               # UI components
│   │   ├── ChatMessage.tsx       # Message with thinking + tool calls
│   │   ├── ThinkingBlock.tsx     # Expandable reasoning
│   │   ├── ToolCallTimeline.tsx  # Tool execution timeline
│   │   ├── MessageInput.tsx      # Chat input
│   │   └── ui/                   # Primitives (tooltip, badge, etc.)
│   ├── hooks/
│   │   ├── usePiStream.ts        # Streaming state machine (useReducer)
│   │   └── useSessions.ts        # Session persistence
│   ├── types/
│   │   ├── index.ts              # ChatMessage, ToolCallInfo
│   │   └── pi-events.ts          # CoworkEvent types
│   ├── App.tsx                   # Main 3-column layout
│   └── App.css                   # Tailwind theme (light + dark)
├── src-tauri/                    # Tauri desktop shell (thin Rust relay)
│   └── src/
│       ├── main.rs               # Entry point
│       └── lib.rs                # IPC commands → sidecar process
├── docs/                         # Architecture & plans
└── .github/workflows/            # CI/CD

Star History

Contributors


🇮🇳 Made in India

Zosma Cowork — built from India by ZOSMAAI SOLUTIONS PRIVATE LIMITED.

Citation

If you use Zosma Cowork in your work, please cite it:

@software{zosma_cowork,
  author  = {Nayak, Arjun and Mhaskar, Akshay and Shanvit and Mishra, Devendra},
  title   = {{Zosma Cowork: A Desktop Agentic Work Harness}},
  url     = {https://github.com/zosmaai/zosma-cowork},
  version = {0.15.2},
  year    = {2026}
}

License

MIT © Zosma AI

Ver o original no GitHub

Bom para

Relacionados