Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@junu0723/tix) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tix

AI-powered CLI that turns any text into actionable tickets.

Feed it meeting transcripts, notes, braindumps, to-do lists — it extracts actionable items and creates Linear or GitHub issues automatically. Designed for AI agents, with a web dashboard for humans.

Try It

npx @junu0723/tix parse --text "Fix the login bug by Friday, add dark mode support" --human

Install

npm install -g @junu0723/tix
tix --help

Prerequisites

Node.js 18+
Claude Code CLI — used for AI-powered parsing

Optional

GitHub CLI (gh) — create GitHub issues without a token

Quick Start

# 1. Configure credentials
tix setup

# 2. Create a project (auto-detects GitHub repo and Linear team)
tix project create my-project

# 3. Add project context for smarter tickets
tix project update my-project \
  --description "E-commerce platform" \
  --stack "Next.js, Prisma, PostgreSQL" \
  --philosophy "Ship fast, user experience over features"

# 4. Parse any text into tickets
tix parse meeting.txt --human

# 5. Parse and create issues in one step
tix parse meeting.txt --push

CLI Reference

All commands output structured JSON to stdout. Status messages go to stderr.

`tix parse`

Parse any text into tickets. Accepts transcripts, notes, to-do lists, braindumps — anything with actionable items.

When a project is active, its context (description, stack, status, philosophy) is used for smarter ticket generation. Duplicate issues are automatically checked before creation.

tix parse meeting.txt                        # from file
cat notes.md | tix parse                     # from stdin
tix parse --text "Fix the login bug"         # inline text
tix parse meeting.txt --push                 # parse + create in Linear
tix parse meeting.txt --push --target github # parse + create in GitHub
tix parse meeting.txt --push --skip-dedup    # skip duplicate check
tix parse meeting.txt --pretty               # pretty JSON output
tix parse meeting.txt --human                # human-readable output

Output includes analysis stats:

{
  "tickets": [{ "title": "...", "description": "...", "priority": 1, "labels": ["bug"] }],
  "count": 3,
  "stats": { "duration_ms": 15800, "input_tokens": 520, "output_tokens": 220, "cost_usd": 0.1166 }
}

`tix create`

Create issues directly from JSON or flags. Checks for duplicates before creating.

tix parse notes.txt | jq '.tickets' | tix create         # pipe from parse
tix create tickets.json                                    # from JSON file
tix create --title "Fix bug" --priority 2 --labels "bug"   # from flags
tix create --target github                                 # target GitHub
tix create --skip-dedup                                    # skip duplicate check

`tix project`

Manage projects with per-project output targets and context. Project context (description, stack, philosophy) is injected into the AI prompt for project-specific ticket generation.

tix project create my-app
tix project update my-app --description "..." --stack "..." --philosophy "..."
tix project use my-app
tix project list --pretty
tix project show --pretty
tix project delete old-project --yes

`tix setup`

Configure API credentials.

tix setup                                                  # interactive
tix setup --linear-api-key KEY --linear-team-id ID         # Linear
tix setup --github-token TOKEN --github-repo owner/repo    # GitHub
tix setup --global                                         # save to ~/.tix/.env

`tix status` · `tix history` · `tix dashboard`

tix status                       # show config and readiness
tix history list --pretty        # view parsing history
tix history clear --yes          # clear history
tix dashboard                    # launch web UI at http://127.0.0.1:8000
tix dashboard --port 3000

Dashboard

The web UI at tix dashboard:

Paste text or upload files (.txt, .md, .srt, .vtt, .csv)
Elapsed time counter during analysis with cancel button
Edit tickets (title, description, priority, labels) before creating
Project selector with context editor
Target selector (Linear / GitHub)
History with creation status tracking

Duplicate Checking

Before creating issues, tix automatically checks for duplicates:

GitHub target → fetches open issues via gh CLI
Linear target → fetches active issues via GraphQL API
Matches by title similarity (substring match + word overlap)
Duplicates are skipped with a warning
Use --skip-dedup to bypass

Integration Backends

Integration	Backend
Claude (parsing)	`claude` CLI subprocess
GitHub (issues)	`gh` CLI (preferred) or REST API via `GITHUB_TOKEN`
Linear (issues)	GraphQL API via `LINEAR_API_KEY`

Environment Variables

Variable	Required for	Description
`LINEAR_API_KEY`	Linear issues	Linear API key
`LINEAR_TEAM_ID`	Linear issues	Linear team UUID (or set per-project)
`GITHUB_TOKEN`	GitHub (API mode)	GitHub token (not needed with `gh` CLI)
`GITHUB_REPO`	GitHub	`owner/repo` (or per-project, or auto-detected from git)

Credentials load from .env (local) or ~/.tix/.env (global).

Claude Code Skill

tix is available as a Claude Code skill. Install it to let Claude Code use tix automatically when you ask to create tickets.

npx skills add junu0723/tix -g -y

# Then just ask Claude Code:
# "turn these meeting notes into Linear issues"
# "create tickets from this braindump"

Uninstall

npm uninstall -g @junu0723/tix
rm -rf ~/.tix

Development

git clone https://github.com/junu0723/tix.git
cd tix
npm install
node bin/tix.js status
node bin/tix.js dashboard

License

MIT

@junu0723/tix