Skip to content

Octane0411/CatWork

Repository files navigation

CatWork logo

CatWork

English | 简体中文

An Electron workspace that keeps an AI agent, a real browser, and terminal tools in the same window.

Built for research, investigation, and browser-heavy workflows where switching between chat, tabs, and shells slows everything down.

Demo

catdesk-demo.mp4

CatWork keeps the task, transcript, and current webpage together so you can watch the agent work instead of reconstructing what happened across different apps.

Why CatWork

Most agent products still treat the browser as a sidecar. CatWork makes it part of the main workspace: you can talk to the agent, inspect the live page it is reading, and keep each task in its own session.

That makes it a better fit for tasks such as web research, information gathering, and lightweight browser-assisted operations where visibility matters as much as the final answer.

What You Can Do

  • Research a topic while the agent navigates and reads real websites
  • Summarize, extract, or reorganize information from the page already open in the app
  • Run bash and browser actions from the same agent loop
  • Keep multiple sessions for different tasks without losing each session's transcript and live browser surface
  • Review assistant output rendered as Markdown, including tool activity and intermediate steps

Current Feature Set

  • Desktop app built with Electron, React, and TypeScript
  • Live in-app browser powered by WebContentsView
  • Streamed assistant output in a session-first workflow
  • Tooling for bash and browser actions such as navigate, read, click, hover, type, press, scroll, and wait
  • Session persistence with transcript recovery on restart
  • Codex OAuth authentication for the current model path

Model Support

CatWork currently supports Codex OAuth. Manual configuration for additional OpenAI-compatible models is planned, but it is not the default path today.

Download

Installers are published on GitHub Releases.

Current artifacts:

  • macOS: .dmg, .zip
  • Windows: .exe
  • Linux: .AppImage

Current release builds are aimed at demos and tester distribution. macOS and Windows packages are not fully signed yet, so first-run security prompts are expected. For the exact install flow, see docs/tester-install.md.

Local Development

Requirements

  • Node.js >= 22
  • npm
  • A desktop environment that can run Electron

Install Dependencies

npm install

Run The App In Development

npm run dev

Build A Local Release

npm run dist

Useful checks:

npm run lint
npm run typecheck
npm run test

License

This project is licensed under the Apache License 2.0. See LICENSE.

About

Desktop AI workspace that brings an agent, a real browser, and terminal tools into one window for research and browser-heavy workflows.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors