Vision
AI as a first-class collaborator, not a black box.
Joyint is an ecosystem of terminal-native, Git-native productivity tools for developers. All data lives in .joy/ (or .jot/) as YAML files, versioned with Git. No database, no lock-in, no server required. AI tools estimate, plan, implement, and review - with full cost tracking.
Why Joyint Exists
Most developer tools treat AI as an afterthought - a plugin, an integration, an API call bolted onto workflows designed for humans alone. Meanwhile, AI is already writing code, reviewing pull requests, and triaging bugs. The gap between what AI can do and what tools allow it to do safely keeps growing.
We believe AI should be a first-class collaborator. That means identity, capabilities, accountability, and limits - the same things you expect from any team member. And we believe the tools that manage this collaboration should live where the code lives: in your terminal, in your Git repo, under your control.
How Joyint Is Different
Most PM tools are built around a web UI and a proprietary database. They own your data, require constant connectivity, and bolt on AI features as an afterthought. Joyint takes a fundamentally different approach.
These are not feature gaps that can be patched over time. They are structural differences in architecture, data ownership, and design philosophy.
| Joyint | Linear / Jira | GitHub / GitLab / Gitea | |
|---|---|---|---|
| Data storage | YAML in your Git repo | Proprietary database | Platform database |
| Offline capability | Full offline, zero dependencies | Cache only | Limited |
| Primary interface | CLI (terminal-first) | Web UI | Web UI |
| Data ownership | Always yours, plain text | Vendor-controlled | Platform-controlled |
| AI governance | Identity, capabilities, gates, cost tracking, audit | Basic or none | Basic permissions |
| Encryption | E2E (AES-256-GCM, key on device) | Server-side | Server-side |
| Self-hosting | Full (CLI works without server) | No (Linear) / Yes (Jira) | Yes (GitLab/Gitea) |
| Data portability | Plain YAML, no export needed | Export required | API export |
| Open source | CLI tools MIT-licensed | Proprietary | Partial |
Structural Advantages
Git-native vs. proprietary database. When your backlog is YAML in Git, you get branching, diffing, merging, and rollback for free. Feature branches carry their own backlog changes. Code review covers planning changes alongside code changes. There is no synchronization problem because there is no separate system to synchronize with.
Offline-first vs. cloud-dependent. Joyint works without any network connection. No server, no API, no latency. This is not a degraded mode - it is the primary mode. Cloud sync is an optional addition, not a requirement.
Data ownership vs. vendor lock-in. Your data is plain YAML on your filesystem. You can read it, script against it, back it up, or migrate it with standard Unix tools. No proprietary format, no export workflow, no API rate limits.
Open source vs. proprietary. The CLI tools are MIT-licensed. You can audit the code, fork it, extend it, or run it without ever creating an account. The platform is commercial, but the core tools are open.
Supported AI Tools
Joy supports two modes of AI integration. In both modes, AI tools are registered as project members with identity, capabilities, delegation tokens, and cost budgets.
Tool Mode available
External AI agents use Joy's CLI as a tool. The agent calls joy commands to read, create, and manage items. joy ai setup detects installed AI tools and generates the appropriate config files with permissions.
| AI Tool | Integration |
|---|---|
| Claude Code (Anthropic) | Skill file + CLAUDE.md |
| GitHub Copilot (GitHub) | .github/copilot-instructions.md |
| Mistral Vibe (Mistral) | Project instructions |
| Qwen Code (Alibaba) | Project instructions |
For tools that support agent definitions (Claude Code, GitHub Copilot, Mistral Vibe), joy ai setup generates tool-specific agent files from the capability YAML blocks - so the AI operates within its granted trust, not from manually written prompts that can drift.
Agent Mode Planned
Joy actively dispatches work to external AI tools and tracks results. Joy is the dispatcher, not the runtime - it prepares context, invokes the tool, and tracks the outcome including cost.
| AI Tool | Command |
|---|---|
| Claude Code (Anthropic) | claude |
| Mistral Vibe (Mistral) | vibe |
| GitHub Copilot (GitHub) | copilot |
| Qwen Code (Alibaba) | qwen |
When an AI tool acts on behalf of a human, the event log traces accountability back to the delegating user:
[ai:claude@joy delegated-by:mac@phoenix.org]Supported Forges
Joy integrates with external forges through ForgeSync, keeping your Git hosting platform in sync with your Joy backlog.
Supported Platforms
| Forge | Authentication | Status |
|---|---|---|
| GitHub | gh CLI or API token | Planned |
| GitLab | glab CLI or API token | Planned |
| Gitea (self-hosted) | API token | Planned |
Mirror Pattern
ForgeSync uses a mirror pattern: your local .joy/ directory is the source of truth. Changes flow from local to joyint.com (if connected), and from joyint.com to the external forge. The external forge receives a read-only mirror of relevant data - issues, milestones, and status updates.
This means you can use Joy for planning and governance while your team continues to interact with GitHub Issues, GitLab Issues, or Gitea. ForgeSync bridges the gap without requiring everyone to switch tools at once.
Core Principles
Git-native. All data lives in .joy/ inside your repo. YAML files, versioned with Git, no external service required to start. Your backlog is diffable, branchable, mergeable - just like your code.
Terminal-first, not terminal-only. The CLI is the primary interface. A TUI, web portal, and native app extend access to all devices. But the terminal is where developers work, and that is where Joy meets you.
AI as a first-class collaborator. AI tools estimate, plan, implement, and review. Joy orchestrates the handoff between human intent and AI execution through its AI Governance architecture - five pillars that together form the Trust Model.
Simple by default, powerful when needed. 10 core commands cover 95% of daily use. Complexity lives in flags, not in the command hierarchy.
Your data, your process. No vendor lock-in, no cloud requirement, no forced workflow migration. The process is defined but not enforced: zero gates means zero ceremony, add gates when your team or your auditors need them.
Start solo, scale to team. Works offline for one person. Add a server when you need collaboration. The workflow does not change.
Progressive adoption. Each step makes the previous one more valuable, but none requires the next.
The Trust Model
The Joyint Trust Model is the architecture that governs human-AI collaboration. It is built on five pillars, each answering a fundamental question:
| Pillar | Question | What It Covers |
|---|---|---|
| Trustship | Who do I trust? | Identity, capabilities, delegation tokens, generated agent definitions |
| Guardianship | What do I protect against? | Runtime validation, gates, encryption, sandbox environments |
| Orchestration | How do I steer work? | Jobs, dispatch, interaction modes, automated workflows |
| Traceability | What happened? | Event log, audit trail, independent verification via Judge |
| Settlement | What did it cost? | Per-job cost tracking, budget enforcement, future on-chain settlement |
The model scales naturally:
| Level | Trust Type | What It Means |
|---|---|---|
| Solo developer | Implicit trust | One member, all capabilities, no gates. Everything works out of the box. |
| Team | Explicit trust | Multiple members with defined capabilities and interaction modes. |
| Enterprise | Verified trust | Gates, mandatory reviews, cost controls, cryptographic identity, and full audit trails. |
For details on each pillar, see the Solutions page.
Compliance and Standards
AI governance is not just a nice-to-have. Regulatory frameworks are catching up with the reality of AI-assisted development. Joyint is designed to help teams meet these requirements without bolting on compliance as an afterthought.
EU AI Act
The EU AI Act (effective August 2025) requires organizations to document AI decision-making, maintain human oversight, and provide transparency about AI involvement. Joyint's Trust Model addresses this directly:
- Human oversight - Gates and
allow_aiflags ensure humans approve critical transitions - Documentation - The event log records every AI action with delegation chains
- Transparency - AI members have visible identity, capabilities, and cost tracking
GDPR / DSGVO
Data protection is built in, not bolted on:
- Data sovereignty - Your data stays in your Git repo. No third-party database.
- E2E encryption - AES-256-GCM with keys on your device. The server never sees plaintext.
- Right to deletion - Plain YAML files in Git. Delete what you need, when you need to.
- Data portability - Your data is always readable YAML. No export tools needed.
SOC 2 / ISO 27001
For organizations pursuing SOC 2 or ISO 27001 certification, Joyint provides:
- Audit trails - Append-only event logs committed to Git, tamper-evident via Judge
- Access controls - Capability-based permissions for humans and AI
- Change management - Every modification tracked, attributed, and signed
- Independent verification - Judge operates as a separate process, reading but never writing
International Compliance
Joyint's architecture - self-hosted deployment, E2E encryption, and local data storage - addresses data residency requirements across jurisdictions.
China - PIPL (Personal Information Protection Law). PIPL requires that personal information collected in China stays within China unless specific conditions are met. Joyint's self-hosted model means data never leaves the infrastructure you control. Qwen Code integration provides a native AI tool option for teams operating under Chinese regulations.
USA - CCPA and SOC 2. The California Consumer Privacy Act and SOC 2 frameworks require clear data handling practices and audit controls. Joyint's event log, capability-based access controls, and independent audit via Judge align with these requirements. FedRAMP considerations are addressed by the self-hosted deployment model, which keeps data within approved boundaries.
Japan - APPI (Act on Protection of Personal Information). APPI mandates appropriate handling of personal information with consent and purpose limitations. Joyint's transparent data model - plain YAML, no hidden processing - supports compliance with APPI's transparency requirements.
Data residency globally. Because Joyint stores all data as local files in your Git repository and encrypts with keys that never leave your device, data residency is determined by where you host your infrastructure, not by where a vendor operates their servers.
Regulated Industries
Finance, healthcare, automotive, and public sector organizations face specific documentation requirements for AI-assisted work. Joyint's combination of cryptographic identity (Trustship), signed events (Guardianship/Crypt), independent audit (Traceability/Judge), and verifiable cost tracking (Settlement) creates an end-to-end compliance chain.
Progressive Adoption
You never have to buy into the whole ecosystem at once. Each layer builds on the previous one, but none requires the next.
Layer 1: Local CLI. Install Joy or Jot. Manage your backlog or todos from the terminal. No account, no server, no internet required.
Layer 2: Team sync. Share the repo with your team. Add joyint.com for real-time sync, web access, and mobile apps.
Layer 3: AI governance. Register AI tools as project members. Define what they can do, who delegates to them, and what requires human approval.
Layer 4: Compliance and audit. Enable Judge for independent verification. Add cryptographic signing via Crypt. Generate compliance reports.
Why Open Source
We love open source. Not as a marketing strategy, but as a conviction.
We release Joy, Jot, Jon, Judge, and Crypt under the MIT license because we believe good tools should be available to everyone. Solo developers, indie hackers, small teams, open source communities, and enterprise organizations - all with the same chance, without privilege or disadvantage.
Our goal is to strengthen the developer community, protect their data from misuse, and elevate collaboration with AI through professional product management. We want to unleash creative minds and see great new apps built by people everywhere - in the open and inside companies.
Good tools set us free.
How We Fund This
The joyint.com platform is a commercial product. It funds our development and infrastructure.
Your Data, Always
Your data is plain YAML in your Git repo. If you stop using Joyint tomorrow, your data stays right where it is. No export, no migration, no vendor negotiation. That is not a feature - it is a promise.