@magic-ingredients/no-tickets

Ticketless project management for AI teams. CLI, MCP server, and SDK in one package.

What is no-tickets?

no-tickets is a project management platform for teams building with AI agents. Instead of manually creating and updating tickets, your dev tools push progress to a dashboard automatically.

• Developers push project state from their repos
• PMs see real-time progress on a hosted dashboard
• AI agents are first-class — their work shows up alongside human work

Quick Start

# Set up a repo (authenticates, connects to project, scaffolds .notickets/)
npx no-tickets init

# Push current state to dashboard
npx no-tickets push

CLI Commands

npx no-tickets init              # Auth + connect to project + scaffold
npx no-tickets push              # Push state to dashboard
npx no-tickets push --ci         # Push from CI (authoritative scores)
npx no-tickets push --dry-run    # Preview what would be pushed
npx no-tickets status            # Connection and auth status
npx no-tickets validate          # Check .notickets/ files against spec
npx no-tickets token create      # Create push token for CI
npx no-tickets token list        # List push tokens
npx no-tickets token revoke      # Revoke a push token

MCP Server

The same package serves as an MCP server when launched by an MCP client (auto-detected via stdin):

{
  "mcpServers": {
    "no-tickets": {
      "command": "npx",
      "args": ["-y", "@magic-ingredients/no-tickets"],
      "env": {
        "NO_TICKETS_TOKEN": "nt_push_xxxxx"
      }
    }
  }
}

Works with Claude Desktop, Cursor, Copilot, Windsurf, and any MCP-compatible tool.

SDK

For programmatic use (e.g., from tiny-brain or custom tooling):

import { computeState, computeDiff, parseFrontmatter } from '@magic-ingredients/no-tickets/sdk';
import type { FeatureState, Phase, StateSnapshot } from '@magic-ingredients/no-tickets/types';

The .notickets/ Format

An open markdown spec for describing work:

.notickets/
├── user-auth/          # epic directory
│   ├── epic.md         # epic definition
│   ├── email-signup.md # feature
│   └── oauth-login.md  # feature
└── payments/
    ├── epic.md
    └── stripe.md

Each file uses YAML frontmatter + markdown. See SPEC.md for the full format specification.

Works with tiny-brain

tiny-brain is an open-source Claude Code plugin that adds TDD enforcement, quality analysis, and adversarial code review. When used with no-tickets, it also pushes telemetry data (model usage, phase compliance, quality scores) that powers the engineering dashboard.

tiny-brain is optional — no-tickets works with any tool.

Contributing

This project uses pnpm as its package manager. The correct version is enforced via corepack:

corepack enable
pnpm install
pnpm run build
pnpm run test
pnpm run lint

Documentation

Full docs at docs.no-tickets.com

License

Apache 2.0 — see LICENSE