freshcrate
Home > AI Agents > 20x

20x

Self-improving Agent orchestrator for all knowledge work

Description

Self-improving Agent orchestrator for all knowledge work

README

20x Logo

20x

License: MIT Version Platform Discord

One app. All your tasks. Powered by AI agents.

20x is a desktop app that turns your task list into an AI-powered workforce. Connect your tools — Linear, HubSpot, YouTrack, GitLab, Notion, Peakflo — assign tasks to AI agents, and watch them work in real time.

No cloud. No subscriptions. Everything runs on your machine.

20x product demo

Why 20x?

Most AI tools make you copy-paste context between tabs. 20x flips it: your tasks come to the agents, not the other way around.

  • Pull a task from Linear → AI agent picks it up, reads the context, writes the code, opens a PR
  • Got a backlog of tickets? → Queue them up, agents work through them while you review
  • Need human approval? → Agents pause and ask before doing anything risky

How It Works

20x process: Hubspot, YouTrack, Linear, Github issues, Peakflo Workflo → triage agent → Agent (Claude Code, Opencode, OpenAI Codex) → HITL review → Feedback

  1. Tasks flow in — from Linear, YouTrack, HubSpot, GitHub Issues, Notion, Peakflo Workflo, or created manually
  2. Triage agent — Assigns priority, coding agent (Claude Code, OpenCode, or Codex), relevant skills, and git repos
  3. Agent works the task — reads skills, git worktrees, and MCP servers; streams output in real time
  4. HITL review — Agents pause for human approval before risky actions
  5. Feedback loop — Skills and confidence levels are automatically updated after completion

Features

20x integrations: Hubspot, YouTrack, Linear, Github issues, Peakflo Workflo → 20x ↔ GitLab, Github, MCP → Claude Code, Opencode, OpenAI Codex; Skills automatically improved

📊 Dashboard Workspace

  • Overview dashboard — See task completion stats, AI autonomy metrics, and agent success rates at a glance
  • Kanban task board — Tasks grouped by status with drag-and-drop support
  • Workflow applications — Launch and manage workflow apps directly from the dashboard
  • Presetup wizard — Guided templates to get started quickly with new applications

🤖 Multi-Agent Support

  • Claude Code — Anthropic's official agent SDK (Claude Sonnet 4.6)
  • OpenCode — Open-source coding agent
  • Codex — OpenAI's agent framework (GPT-5.4)
  • Live transcripts — Watch agents think and work in real time with message counts
  • Human-in-the-loop — Approve risky actions before execution
  • Task progress tracking — Real-time progress events during agent execution

🔗 Smart Integrations

  • Linear — Pull issues, update status, post comments
  • HubSpot — Sync tickets and workflows
  • YouTrack — Connect JetBrains YouTrack projects and tasks
  • GitLab — Full GitLab integration for task sourcing and repositories
  • Notion — Sync Notion databases with full property and attachment support
  • Peakflo — Connect your Peakflo Workflo tasks
  • GitHub Issues — Pull issues directly from GitHub repositories
  • OAuth built-in — Secure authentication flows

🧠 Skills System

  • Reusable instructions — Create skill templates for common patterns
  • Auto-learning — Agents update skills based on feedback
  • Confidence tracking — Skills improve over time
  • 2-way sync — Skills synchronize bidirectionally between 20x and Workflo
  • Searchable skills — Quickly find skills with built-in search

🛠 Developer-First

  • Git worktree management — Isolated branches per task
  • Repository context — Agents know which repos to work on (GitHub & GitLab)
  • MCP servers — Connect Model Context Protocol tools with auto-registration
  • Local-first — SQLite database, no cloud required

📋 Task Management

  • Subtasks — Break tasks into subtasks with ordering and drag-and-drop reordering
  • Recurring tasks — Daily, weekly, monthly schedules
  • Task snoozing — Snooze tasks and have them resurface at the right time
  • Rich metadata — Types, priorities, due dates, labels
  • File attachments — Add context files to tasks
  • Output fields — Structured task results
  • Smart search — Find anything fast

💓 Heartbeat Monitoring

  • Enterprise heartbeat — Continuous health checks with GitHub preflight
  • CI failure detection — Automatically detect CI pipeline failures
  • State syncing — Keep task state in sync across sessions

Getting Started

Supported Platforms

  • macOS — Full support
  • Windows — Full support
  • Linux — AppImage installer

Prerequisites

  • Node.js >= 22
  • pnpm >= 9
  • Git (for worktree features)
  • GitHub CLI (optional, for GitHub repo features)
  • GitLab CLI (optional, for GitLab repo features)

Installation

# Clone the repository
git clone https://github.com/peakflo/20x.git
cd 20x

# Install dependencies
pnpm install

macOS: Opening the App (Release Build)

macOS may block the app since it's not signed with an Apple Developer certificate. To open it, use one of these methods:

Option A: Right-click the app in /Applications and select Open, then confirm in the dialog.

Option B: Run in Terminal:

sudo xattr -cr /Applications/20x.app

Then open the app normally.

This is not required if you build from source and run with pnpm dev.

Configuration

API Keys: Configure in Agent Settings:

  • Anthropic API key for Claude Code
  • OpenAI API key for OpenCode (if needed)

Database:

  • Stored at ~/Library/Application Support/pf-desktop/pf-desktop.db (macOS)
  • Automatic backups before migrations

Integrations:

  1. Get OAuth credentials from Linear/HubSpot/Peakflo
  2. Configure in Integrations settings
  3. Complete OAuth flow in-app

Development

# Start dev server
pnpm run dev

# Run tests
pnpm test

# Build for distribution
pnpm run build:mac    # macOS
pnpm run build:win    # Windows
pnpm run build:linux  # Linux

Architecture

Data Flow

React UI → Zustand Store → IPC Client → Preload Bridge → Main Process → SQLite
  • Renderer — React 19 + Tailwind CSS 4 + Zustand 5
  • Main Process — Electron 34 + SQLite + Agent orchestration
  • Security — Full context isolation, no Node.js in renderer

Agent Architecture

Session Lifecycle:

  1. Start — Agent assigned, skills applied, session created
  2. Streaming — Real-time output sent to UI
  3. Approval — Agent pauses for human decisions
  4. Completion — Results saved, task updated

See AGENTS.md for detailed architecture.

Tech Stack

Layer Technology
Shell Electron 34
Build electron-vite
Frontend React 19 + Tailwind CSS 4 + Zustand 5
UI Components Radix UI primitives
Styling cva + Tailwind CSS tokens
Icons Lucide React
Font Geist
Database SQLite (better-sqlite3, WAL mode)
Agent SDKs @opencode-ai/sdk, @anthropic-ai/claude-agent-sdk, @zed-industries/codex-acp
Testing Vitest + happy-dom

Contributing

We welcome contributions! Here's how:

  1. Fork the repo
  2. Create a branch: git checkout -b feature/my-feature
  3. Write code: Follow TypeScript strict mode, ESLint, Prettier
  4. Add tests: Vitest tests for new features
  5. Commit: Use conventional commits (feat:, fix:, etc.)
  6. Push: git push origin feature/my-feature
  7. Open PR: Describe changes, ensure CI passes

Code Style

  • TypeScript strict mode
  • Minimal Tailwind classes (prefer CSS variables)
  • Use pnpm (not npm)
  • Check MEMORY.md for project patterns

Community

Security

Local-First

  • All data stored locally in SQLite
  • No cloud sync, no subscriptions
  • Optional database encryption

OAuth & API Keys

  • Tokens encrypted with Electron safeStorage
  • Keys never exposed to renderer process
  • Parameterized SQL queries only

Electron Security

  • contextIsolation: true
  • nodeIntegration: false
  • External links open in system browser

Roadmap

Planned

  • Additional integrations (Jira, Asana)
  • Team collaboration (shared task sources)
  • Cost tracking (token usage per session)
  • Agent templates (pre-configured profiles)
  • Plugin marketplace (community skills)
  • Light theme

Recently Shipped

  • ✅ Dashboard workspace with Kanban board and workflow apps
  • ✅ Subtask support with ordering and drag-and-drop
  • ✅ GitLab integration (task sourcing & repositories)
  • ✅ YouTrack integration
  • ✅ Notion integration with full property support
  • ✅ GitHub Issues integration
  • ✅ Windows and Linux platform support
  • ✅ Task snoozing
  • ✅ Skills 2-way sync with Workflo
  • ✅ Heartbeat monitoring with CI failure detection
  • ✅ Presetup wizard and dashboard templates
  • ✅ Claude Sonnet 4.6 and GPT-5.4 model support
  • ✅ Multi-agent support (OpenCode, Claude Code, Codex)
  • ✅ Skills system with auto-learning
  • ✅ Recurring tasks
  • ✅ Linear, HubSpot, Peakflo integrations
  • ✅ MCP server management
  • ✅ Git worktree management

License

MIT © 2026 Peakflo


Built with Electron, React, and Anthropic Claude.

Release History

VersionChangesUrgencyDate
v0.0.68## What's Changed * fix: close dashboard preview modal when opening canvas by @dimavedenyapin in https://github.com/peakflo/20x/pull/259 * fix: strip Electron from user-agent to prevent Xero WAF blocking by @dimavedenyapin in https://github.com/peakflo/20x/pull/260 * fix: add timeout to opencode connection testing by @dimavedenyapin in https://github.com/peakflo/20x/pull/261 * [TSK-16090] windows improvement by @fan0916 in https://github.com/peakflo/20x/pull/263 ## New Contributors * @fan0916 mHigh4/21/2026
v0.0.67## What's Changed * feat: canvas panel interactions and integrations by @dimavedenyapin in https://github.com/peakflo/20x/pull/258 **Full Changelog**: https://github.com/peakflo/20x/compare/v0.0.66...v0.0.67High4/19/2026
v0.0.65## What's Changed * fix(ci): unblock Windows installer by pinning Python 3.11 by @dimavedenyapin in https://github.com/peakflo/20x/pull/256 **Full Changelog**: https://github.com/peakflo/20x/compare/v0.0.64...v0.0.65High4/19/2026
v0.0.44## What's Changed * feat: allow reusing existing integrations in presetup wizard by @dimavedenyapin in https://github.com/peakflo/20x/pull/195 * test: verify opencode adapter getStatus fallback by @dimavedenyapin in https://github.com/peakflo/20x/pull/189 * Reduce spammy ACP backend logs by @dimavedenyapin in https://github.com/peakflo/20x/pull/192 * fix: add dedicated 403 error handling in enterprise API client by @dimavedenyapin in https://github.com/peakflo/20x/pull/196 * fix: exclude recurriHigh4/14/2026
v0.0.43## What's Changed * fix: setup worktree for triaged tasks when starting session by @dimavedenyapin in https://github.com/peakflo/20x/pull/179 * fix capture of last invoices by @dimavedenyapin in https://github.com/peakflo/20x/pull/183 * Add structured enterprise auth logout reason logging by @dimavedenyapin in https://github.com/peakflo/20x/pull/184 * Replace per-skill sync with batch-sync API call on login by @dimavedenyapin in https://github.com/peakflo/20x/pull/185 * Fix missing worktrees wheHigh4/9/2026
v0.0.42## What's Changed * fix: mobile web session management + backend session tracking by @dimavedenyapin in https://github.com/peakflo/20x/pull/178 * fix: resolve Windows installer UAC elevation error by @kunalpurohit-peakflo in https://github.com/peakflo/20x/pull/181 * codex opencode fixes by @dimavedenyapin in https://github.com/peakflo/20x/pull/182 * fix: propagate waiting_approval status to enable opencode questions by @dimavedenyapin in https://github.com/peakflo/20x/pull/180 **Full ChangelogHigh4/8/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

nanoclawA lightweight alternative to OpenClaw that runs in containers for security. Connects to WhatsApp, Telegram, Slack, Discord, Gmail and other messaging apps,, has memory, scheduled jobs, and runs directmain@2026-04-21
guardian-agentSecurity-first AI agent orchestration system. Built-in agents with predefined capabilities, strict guardrails on what they can and cannot do, and a four-layer defense system that enforces security at main@2026-04-21
be-my-butlerOrchestrate multiple agents to execute Claude Code workflows with cross-model verification for reliable AI code automation.main@2026-04-21
cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMsv1.9.2
maestro-orchestrateMulti-agent orchestration platform for Gemini CLI and Claude Code — 22 specialists, parallel subagents, persistent sessions, and built-in code review, debugging, security, SEO, accessibility, and compv1.6.2