Back to docs

Introduction

What is Opentix and why use it for ticket management.

What is Opentix?

Opentix is a VS Code extension for git-native ticket management. Instead of relying on external tools like Jira, Linear, or GitHub Issues, Opentix stores every ticket as a Markdown file with YAML frontmatter — right inside your repository.

You get a full-featured Kanban board inside VS Code, sprint management, team collaboration through Git, and AI-ready ticket context that works with any coding assistant.

Key Features

  • Kanban Board — A drag-and-drop board inside VS Code. Move tickets between columns to change their status.
  • Markdown Tickets — Each ticket is a .md file with structured YAML frontmatter and Markdown sections for description, acceptance criteria, and comments.
  • Git-Native Storage — All ticket data lives in .opentix/ on your repository's default branch. It syncs through Git — no external server needed.
  • Worktree Isolation — Opentix uses a git worktree so your working branch is never affected by ticket operations.
  • Auto-Sync — Background pull/push keeps the team in sync automatically.
  • Sprint Management — Define sprints and breaks, assign tickets, and filter the board by sprint.
  • Team & Assignees — Self-registering team member list. Assign tickets to yourself or teammates.
  • AI Context — Automatically detects the current ticket from your branch name and writes context files for AI assistants like Cursor, Copilot, Windsurf, and Claude Code.
  • Git Automations (Planned) — A future rule engine to auto-transition ticket status based on branch and pull request events.

How It Differs

OpentixJira / LinearGitHub Issues
Data locationIn the repoExternal serverGitHub API
Offline supportFullNoneLimited
Vendor lock-inNoneHighMedium
AI integrationBuilt-in context filesRequires pluginsRequires setup
Setup timeOne commandAccount + project setupPer-repo config
CostFree & open sourcePaid plansFree (limited)

Next Steps