JoyintJoyint Docs

Toolchain

All products in the Joyint ecosystem.

The Joyint ecosystem consists of open-source CLI tools and the joyint.com platform. Each tool works standalone, but they share a common foundation (joy-core) and integrate seamlessly.

The Three Pillars

ProductRoleDescription
JoyPlanningProduct management - epics, stories, tasks, milestones, releases, AI governance
JotExecutionPersonal todos - fast task capture, tags, priorities, effort tracking
JonUnderstandingNatural language interface - talk to Joy and Jot in plain language

Joy handles project planning. Jot handles personal execution. Jon bridges the gap: a natural language layer that lets you interact with both tools conversationally, without memorizing commands.

CLI Tools

ProductDescriptionLicenseStatus
JoyProduct management - epics, stories, tasks, milestones, releases, AI governanceMITBeta
JotPersonal todos - fast task capture, tags, priorities, effort trackingMITBeta
JonNatural language interface for Joy and JotMITPlanned

Jon Planned

Jon is the natural language interface for the Joyint ecosystem. Instead of remembering CLI syntax, you describe what you want in plain language, and Jon translates that into the right Joy or Jot commands.

Three-tier intelligence. Jon uses a layered approach to handle requests at the right level:

  • Pattern Router - Handles common, well-defined commands instantly and offline. "Show my open tasks" maps directly to joy ls --status open --mine without any AI call. Fast, predictable, no cost.
  • External LLM - For complex reasoning, ambiguous requests, or multi-step operations, Jon routes to an external language model. "Plan a sprint from these open stories based on priority and effort" requires understanding context that pattern matching cannot handle.

Onboarding layer. Jon lowers the barrier to entry. New team members interact with Joy and Jot through conversation before learning the CLI. The commands Jon generates are shown transparently, so users learn the CLI naturally over time.

Toolchain manager. Jon manages the Joyint toolchain itself:

  • jon install - Install or update Joy, Jot, and other ecosystem tools
  • jon update - Check for and apply updates across the toolchain
  • jon doctor - Diagnose configuration issues, check tool versions, verify setup

Multi-project aggregator. For developers working across multiple repositories, Jon aggregates context. "What is blocking me across all projects?" queries multiple Joy instances and presents a unified view.

joyint.com

The platform ties the CLI tools together with collaboration, sync, and additional capabilities.

  • Sync - Push and pull project data across machines and team members
  • Web UI - Browse and manage backlogs from the browser
  • Jon - Natural language interface, available in the web UI and as CLI
  • Apps - Desktop (Tauri/React) and mobile apps for iOS and Android
  • CalDAV - Sync Jot tasks with Apple Reminders, Google Calendar, and other clients
  • ForgeSync - Mirror Joy data to GitHub, GitLab, or Gitea
  • Notifications - Status changes, mentions, blocked items
  • Judge - Independent audit layer for event verification and compliance reports
  • Crypt - End-to-end encryption for sensitive project data
  • Dispatcher - AI orchestration, capability-based task routing
  • Settlement - Future on-chain settlement for AI cost tracking

Architecture

All CLI tools are built in Rust and ship as single static binaries. They share joy-core, a library that provides the storage layer, event log, configuration system, and item model.

The platform reads and writes the same YAML files. Your Git repo remains the source of truth - the platform adds collaboration on top.

Open Source First

Joy, Jot, and Jon are MIT-licensed. The platform is a commercial product that funds continued development. You can always use the CLI tools without the platform, and your data never leaves your repo unless you choose to sync it.