Skip to content

anastomotic-ai/anastomotic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | 中文 | 日本語 | 한국어 | Русский | Español | Türkçe | العربية | Bahasa Indonesia | தமிழ் | हिन्दी

Anastomotic™ - Open Source AI Desktop Agent

Anastomotic is an open source AI desktop agent that automates file management, document creation, and browser tasks locally on your machine. Bring your own API keys (OpenAI, Anthropic, Google, xAI) or run local models via Ollama.

Runs locally on your machine. Bring your own API keys or local models. MIT licensed.

Download for Mac (Apple Silicon) · Download for Mac (Intel) · Download for Windows 11 · Download for Linux (ARM64) · Download for Linux (x64) · Download for Linux (.deb x64) · Anastomotic website · Anastomotic blog · Anastomotic releases




What makes it different

🖥️ It runs locally

  • Your files stay on your machine
  • You decide which folders it can touch
  • Nothing gets sent to Anastomotic (or anyone else)

🔑 You bring your own AI

  • Use your own API key (OpenAI, Anthropic, etc.)
  • Or run with Ollama (no API key needed)
  • No subscription, no upsell
  • It's a tool—not a service

📖 It's open source

  • Every line of code is on GitHub
  • MIT licensed
  • Change it, fork it, break it, fix it

⚡ It acts, not just chats

  • File management
  • Document creation
  • Custom automations
  • Skill learning



Features

Core Capabilities

Feature Description
📁 File Management Sort, rename, and move files based on content or rules
✍️ Document Writing Write, summarize, or rewrite documents with AI
🔗 Tool Connections Integrate with Notion, Google Drive, Dropbox via local APIs
⚙️ Custom Skills Define repeatable workflows and save them as skills
🛡️ Full Control Approve every action, view logs, stop anytime

Advanced Features

Feature Description
📅 Scheduled Tasks Schedule AI tasks with cron expressions — run daily reports, weekly cleanups, or hourly checks automatically
💰 Cost Tracking Monitor token usage and API costs per task with detailed breakdowns by model and provider
🧠 Auto-Learning Automatically extracts reusable insights from completed tasks and applies them to improve future results
🔀 Multi-Agent Pipelines Orchestrate multi-step workflows with sequential, parallel, or conditional agent pipelines
🔧 Git-Aware Code Agent Detects current branch and repo status — suggests git-related actions contextually on the home screen
📤 Export & Share Results Export task results as Markdown, JSON, or plain text — or copy to clipboard with one click
💡 Smart Task Suggestions Heuristic suggestion engine on the home page that recommends follow-up tasks based on recent activity
🏪 Skill Marketplace Browse and install community skills from a curated marketplace with one-click install
🔔 Notification Webhooks Send HTTP POST notifications to Slack, Discord, or any webhook URL on task completion or failure



What it actually does

📁 File Management ✍️ Document Writing 🔗 Tool Connections
Sort, rename, and move files based on content or rules you give it Prompt it to write, summarize, or rewrite documents Works with Notion, Google Drive, Dropbox, and more (through local APIs)
⚙️ Custom Skills 🛡️ Full Control
Define repeatable workflows, save them as skills You approve every action. You can see logs. You can stop it anytime.

Use cases

  • Clean up messy folders by project, file type, or date
  • Draft, summarize, and rewrite docs, reports, and meeting notes
  • Automate browser workflows like research and form entry
  • Generate weekly updates from files and notes
  • Prepare meeting materials from docs and calendars

Supported models and providers

  • Anthropic (Claude)
  • OpenAI (GPT)
  • Google AI (Gemini)
  • xAI (Grok)
  • DeepSeek
  • Moonshot AI (Kimi)
  • Z.AI (GLM)
  • MiniMax
  • Venice.ai
  • Amazon Bedrock
  • Azure Foundry
  • OpenRouter
  • LiteLLM
  • Ollama (local models)
  • LM Studio (local models)

Privacy and local-first

Anastomotic runs locally on your machine. Your files stay on your device, and you choose which folders it can access.


System requirements

  • macOS (Apple Silicon)
  • macOS (Intel)
  • Windows 11
  • Ubuntu (ARM64)
  • Ubuntu (x64)



How to use it

Takes 2 minutes to set up.

Step Action Details
1 Install the App Download the DMG and drag it into Applications
2 Connect Your AI Use your own Google, OpenAI, Anthropic (or other) API key — or sign in with ChatGPT (Plus/Pro). No subscriptions.
3 Give It Access Choose which folders it can see. You stay in control.
4 Start Working Ask it to summarize a doc, clean a folder, or create a report. You approve everything.





FAQ

Does Anastomotic run locally?
Yes. Anastomotic runs locally on your machine and you control which folders it can access.

Do I need an API key?
You can use your own API keys (OpenAI, Anthropic, Google, xAI, etc.) or run local models via Ollama.

Is Anastomotic free?
Yes. Anastomotic is open source and MIT licensed.

Which platforms are supported? macOS (Apple Silicon), macOS (Intel), Windows 11, Ubuntu ARM64, and Ubuntu x64 are supported.




Development

pnpm install
pnpm dev

That's it.

Prerequisites
  • Node.js 20+
  • pnpm 9+
All Commands
Command Description
pnpm dev Run desktop app in dev mode
pnpm dev:clean Dev mode with clean start
pnpm build Build all workspaces
pnpm build:desktop Build desktop app only
pnpm -F @anastomotic/desktop package:win Build Windows installer (x64)
pnpm -F @anastomotic/desktop package:linux Build Linux artifacts (AppImage + deb)
pnpm lint TypeScript checks
pnpm typecheck Type validation
pnpm -F @anastomotic/desktop test:e2e Playwright E2E tests
Environment Variables
Variable Description
CLEAN_START=1 Clear all stored data on app start
E2E_SKIP_AUTH=1 Skip onboarding flow (for testing)
Architecture
apps/
  desktop/        # Electron app (main + preload + renderer)
packages/
  shared/         # Shared TypeScript types

The desktop app uses Electron with a React UI bundled via Vite. The main process spawns OpenCode CLI using node-pty to execute tasks. API keys are stored securely in the OS keychain.

See CLAUDE.md for detailed architecture documentation.




Contributing

Contributions welcome! Feel free to open a PR.

# Fork → Clone → Branch → Commit → Push → PR
git checkout -b feature/amazing-feature
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature



Anastomotic website · Anastomotic blog · Anastomotic releases · Issues · Twitter


MIT License · Built by Anastomotic


Keywords: AI agent, AI desktop agent, desktop automation, file management, document creation, browser automation, local-first, macOS, linux, ubuntu, privacy-first, open source, Electron, computer use, AI assistant, workflow automation, OpenAI, Anthropic, Google, xAI, Claude, GPT-4, Ollama

About

The open source AI coworker that lives on your desktop

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors