@dabble/linear-cli 1.0.4 → 1.1.0

package/bin/linear.mjs

@@ -14,6 +14,7 @@ const API_URL = 'https://api.linear.app/graphql';
 let CONFIG_FILE = '';
 let LINEAR_API_KEY = '';
 let TEAM_KEY = '';
+let ALIASES = {};
 
 // Colors (ANSI)
 const colors = {
@@ -43,12 +44,32 @@ function loadConfig() {
   // Load from config file first (highest priority)
   if (CONFIG_FILE) {
     const content = readFileSync(CONFIG_FILE, 'utf-8');
+    let inAliasSection = false;
+
     for (const line of content.split('\n')) {
-      if (!line || line.startsWith('#')) continue;
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) continue;
+
+      // Check for section header
+      if (trimmed === '[aliases]') {
+        inAliasSection = true;
+        continue;
+      }
+      if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        inAliasSection = false;
+        continue;
+      }
+
       const [key, ...rest] = line.split('=');
       const value = rest.join('=').trim();
-      if (key === 'api_key') LINEAR_API_KEY = value;
-      if (key === 'team') TEAM_KEY = value;
+
+      if (inAliasSection) {
+        // Store aliases with uppercase keys
+        ALIASES[key.trim().toUpperCase()] = value;
+      } else {
+        if (key.trim() === 'api_key') LINEAR_API_KEY = value;
+        if (key.trim() === 'team') TEAM_KEY = value;
+      }
     }
   }
 
@@ -57,6 +78,107 @@ function loadConfig() {
   if (!TEAM_KEY) TEAM_KEY = process.env.LINEAR_TEAM || '';
 }
 
+function resolveAlias(nameOrAlias) {
+  if (!nameOrAlias) return nameOrAlias;
+  return ALIASES[nameOrAlias.toUpperCase()] || nameOrAlias;
+}
+
+function saveAlias(code, name) {
+  if (!CONFIG_FILE) {
+    console.error(colors.red('Error: No config file found. Run "linear login" first.'));
+    process.exit(1);
+  }
+
+  const content = readFileSync(CONFIG_FILE, 'utf-8');
+  const lines = content.split('\n');
+
+  // Find or create [aliases] section
+  let aliasStart = -1;
+  let aliasEnd = -1;
+  let existingAliasLine = -1;
+  const upperCode = code.toUpperCase();
+
+  for (let i = 0; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (trimmed === '[aliases]') {
+      aliasStart = i;
+    } else if (aliasStart !== -1 && aliasEnd === -1) {
+      if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        aliasEnd = i;
+      } else if (trimmed && !trimmed.startsWith('#')) {
+        const [key] = trimmed.split('=');
+        if (key.trim().toUpperCase() === upperCode) {
+          existingAliasLine = i;
+        }
+      }
+    }
+  }
+
+  // If no alias section end found, it goes to EOF
+  if (aliasStart !== -1 && aliasEnd === -1) {
+    aliasEnd = lines.length;
+  }
+
+  const aliasLine = `${upperCode}=${name}`;
+
+  if (existingAliasLine !== -1) {
+    // Update existing alias
+    lines[existingAliasLine] = aliasLine;
+  } else if (aliasStart !== -1) {
+    // Add to existing section
+    lines.splice(aliasStart + 1, 0, aliasLine);
+  } else {
+    // Create new section at end
+    if (lines[lines.length - 1] !== '') {
+      lines.push('');
+    }
+    lines.push('[aliases]');
+    lines.push(aliasLine);
+  }
+
+  writeFileSync(CONFIG_FILE, lines.join('\n'));
+  ALIASES[upperCode] = name;
+}
+
+function removeAlias(code) {
+  if (!CONFIG_FILE) {
+    console.error(colors.red('Error: No config file found.'));
+    process.exit(1);
+  }
+
+  const upperCode = code.toUpperCase();
+  if (!ALIASES[upperCode]) {
+    console.error(colors.red(`Alias not found: ${code}`));
+    process.exit(1);
+  }
+
+  const content = readFileSync(CONFIG_FILE, 'utf-8');
+  const lines = content.split('\n');
+  let inAliasSection = false;
+
+  const newLines = lines.filter(line => {
+    const trimmed = line.trim();
+    if (trimmed === '[aliases]') {
+      inAliasSection = true;
+      return true;
+    }
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+      inAliasSection = false;
+      return true;
+    }
+    if (inAliasSection && trimmed && !trimmed.startsWith('#')) {
+      const [key] = trimmed.split('=');
+      if (key.trim().toUpperCase() === upperCode) {
+        return false;
+      }
+    }
+    return true;
+  });
+
+  writeFileSync(CONFIG_FILE, newLines.join('\n'));
+  delete ALIASES[upperCode];
+}
+
 function checkAuth() {
   if (!LINEAR_API_KEY) {
     console.error(colors.red("Error: Not logged in. Run 'linear login' first."));
@@ -132,16 +254,27 @@ function openBrowser(url) {
   exec(cmd);
 }
 
+// Strip ANSI escape codes for length calculation
+function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
 function formatTable(rows) {
   if (rows.length === 0) return '';
   const colWidths = [];
   for (const row of rows) {
     row.forEach((cell, i) => {
-      colWidths[i] = Math.max(colWidths[i] || 0, String(cell).length);
+      // Use visible length (without ANSI codes) for width calculation
+      colWidths[i] = Math.max(colWidths[i] || 0, stripAnsi(String(cell)).length);
     });
   }
   return rows.map(row =>
-    row.map((cell, i) => String(cell).padEnd(colWidths[i])).join('  ')
+    row.map((cell, i) => {
+      const str = String(cell);
+      const visibleLen = stripAnsi(str).length;
+      // Pad based on visible length, not string length
+      return str + ' '.repeat(Math.max(0, colWidths[i] - visibleLen));
+    }).join('  ')
   ).join('\n');
 }
 
@@ -187,6 +320,7 @@ async function cmdIssues(args) {
     milestone: 'string',
     state: 'string', s: 'string',
     label: 'string', l: 'string',
+    priority: 'string',
   });
 
   const inProgress = opts['in-progress'];
@@ -199,6 +333,7 @@ async function cmdIssues(args) {
   const milestoneFilter = opts.milestone;
   const stateFilter = opts.state || opts.s;
   const labelFilter = opts.label || opts.l;
+  const priorityFilter = (opts.priority || '').toLowerCase();
 
   // Get current user ID for filtering/sorting
   const viewerResult = await gql('{ viewer { id } }');
@@ -234,26 +369,35 @@ async function cmdIssues(args) {
   // Check if any issues have assignees (to decide whether to show column)
   const hasAssignees = issues.some(i => i.assignee);
 
-  // Sort: assigned to you first, then by priority, then by sortOrder
+  // Sort: assigned to you first, then by priority (urgent first), then by sortOrder
   issues.sort((a, b) => {
     const aIsMine = a.assignee?.id === viewerId;
     const bIsMine = b.assignee?.id === viewerId;
     if (aIsMine && !bIsMine) return -1;
     if (!aIsMine && bIsMine) return 1;
-    // Then by priority (higher = more urgent)
-    if ((b.priority || 0) !== (a.priority || 0)) return (b.priority || 0) - (a.priority || 0);
+    // Then by priority (lower number = more urgent, but 0 means no priority so sort last)
+    const aPri = a.priority || 5; // No priority (0) sorts after Low (4)
+    const bPri = b.priority || 5;
+    if (aPri !== bPri) return aPri - bPri;
     // Then by sortOrder
     return (b.sortOrder || 0) - (a.sortOrder || 0);
   });
 
+  // Check if any issues have priority set
+  const hasPriority = issues.some(i => i.priority > 0);
+
   // Helper to format issue row
   const formatRow = (i) => {
     const row = [
       i.identifier,
       i.title,
       i.state.name,
-      i.project?.name || '-'
     ];
+    if (hasPriority) {
+      const pri = PRIORITY_LABELS[i.priority] || '';
+      row.push(pri ? colors.bold(pri) : '-');
+    }
+    row.push(i.project?.name || '-');
     if (hasAssignees) {
       const assignee = i.assignee?.id === viewerId ? 'you' : (i.assignee?.name || '-');
       row.push(assignee);
@@ -273,15 +417,23 @@ async function cmdIssues(args) {
       );
     }
     if (projectFilter) {
+      const resolvedProject = resolveAlias(projectFilter);
       filtered = filtered.filter(i =>
-        i.project?.name?.toLowerCase().includes(projectFilter.toLowerCase())
+        i.project?.name?.toLowerCase().includes(resolvedProject.toLowerCase())
       );
     }
     if (milestoneFilter) {
+      const resolvedMilestone = resolveAlias(milestoneFilter);
       filtered = filtered.filter(i =>
-        i.projectMilestone?.name?.toLowerCase().includes(milestoneFilter.toLowerCase())
+        i.projectMilestone?.name?.toLowerCase().includes(resolvedMilestone.toLowerCase())
       );
     }
+    if (priorityFilter) {
+      const targetPriority = PRIORITY_MAP[priorityFilter];
+      if (targetPriority !== undefined) {
+        filtered = filtered.filter(i => i.priority === targetPriority);
+      }
+    }
     return filtered;
   };
 
@@ -497,6 +649,24 @@ const ESTIMATE_MAP = {
   'xl': 5,
 };
 
+// Linear priority values (lower number = higher priority)
+// 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
+const PRIORITY_LABELS = {
+  0: '',
+  1: 'Urgent',
+  2: 'High',
+  3: 'Medium',
+  4: 'Low',
+};
+
+const PRIORITY_MAP = {
+  'urgent': 1,
+  'high': 2,
+  'medium': 3,
+  'low': 4,
+  'none': 0,
+};
+
 async function cmdIssueCreate(args) {
   const opts = parseArgs(args, {
     title: 'string', t: 'string',
@@ -507,6 +677,7 @@ async function cmdIssueCreate(args) {
     state: 'string', s: 'string',
     assign: 'boolean',
     estimate: 'string', e: 'string',
+    priority: 'string',
     label: 'string', l: 'string',
     blocks: 'string',
     'blocked-by': 'string',
@@ -514,8 +685,9 @@ async function cmdIssueCreate(args) {
 
   const title = opts.title || opts.t || opts._[0];
   const description = opts.description || opts.d || '';
-  const project = opts.project || opts.p;
-  const milestone = opts.milestone;
+  const project = resolveAlias(opts.project || opts.p);
+  const priority = (opts.priority || '').toLowerCase();
+  const milestone = resolveAlias(opts.milestone);
   const parent = opts.parent;
   const shouldAssign = opts.assign;
   const estimate = (opts.estimate || opts.e || '').toLowerCase();
@@ -525,7 +697,7 @@ async function cmdIssueCreate(args) {
 
   if (!title) {
     console.error(colors.red('Error: Title is required'));
-    console.error('Usage: linear issue create --title "Issue title" [--project "..."] [--milestone "..."] [--parent ISSUE-X] [--estimate M] [--assign] [--label bug] [--blocks ISSUE-X] [--blocked-by ISSUE-X]');
+    console.error('Usage: linear issue create --title "Issue title" [--project "..."] [--milestone "..."] [--parent ISSUE-X] [--estimate M] [--priority urgent] [--assign] [--label bug] [--blocks ISSUE-X] [--blocked-by ISSUE-X]');
     process.exit(1);
   }
 
@@ -535,6 +707,12 @@ async function cmdIssueCreate(args) {
     process.exit(1);
   }
 
+  // Validate priority
+  if (priority && !PRIORITY_MAP.hasOwnProperty(priority)) {
+    console.error(colors.red(`Error: Invalid priority "${priority}". Use: urgent, high, medium, low, or none`));
+    process.exit(1);
+  }
+
   // Get team UUID (required for mutations)
   const teamResult = await gql(`{ team(id: "${TEAM_KEY}") { id } }`);
   const teamId = teamResult.data?.team?.id;
@@ -626,6 +804,7 @@ async function cmdIssueCreate(args) {
   if (parent) input.parentId = parent;
   if (assigneeId) input.assigneeId = assigneeId;
   if (estimate) input.estimate = ESTIMATE_MAP[estimate];
+  if (priority) input.priority = PRIORITY_MAP[priority];
   if (labelIds.length > 0) input.labelIds = labelIds;
 
   const result = await gql(mutation, { input });
@@ -633,7 +812,8 @@ async function cmdIssueCreate(args) {
   if (result.data?.issueCreate?.success) {
     const issue = result.data.issueCreate.issue;
     const estLabel = estimate ? ` [${estimate.toUpperCase()}]` : '';
-    console.log(colors.green(`Created: ${issue.identifier}${estLabel}`));
+    const priLabel = priority && priority !== 'none' ? ` [${priority.charAt(0).toUpperCase() + priority.slice(1)}]` : '';
+    console.log(colors.green(`Created: ${issue.identifier}${estLabel}${priLabel}`));
     console.log(issue.url);
 
     // Create blocking relations if specified
@@ -680,19 +860,32 @@ async function cmdIssueUpdate(args) {
     state: 'string', s: 'string',
     project: 'string', p: 'string',
     milestone: 'string',
+    priority: 'string',
     append: 'string', a: 'string',
+    check: 'string',
+    uncheck: 'string',
     blocks: 'string',
     'blocked-by': 'string',
   });
 
   const blocksIssue = opts.blocks;
   const blockedByIssue = opts['blocked-by'];
-  const projectName = opts.project || opts.p;
-  const milestoneName = opts.milestone;
+  const projectName = resolveAlias(opts.project || opts.p);
+  const milestoneName = resolveAlias(opts.milestone);
+  const priorityName = (opts.priority || '').toLowerCase();
   const input = {};
 
   if (opts.title || opts.t) input.title = opts.title || opts.t;
 
+  // Handle priority
+  if (priorityName) {
+    if (!PRIORITY_MAP.hasOwnProperty(priorityName)) {
+      console.error(colors.red(`Error: Invalid priority "${priorityName}". Use: urgent, high, medium, low, or none`));
+      process.exit(1);
+    }
+    input.priority = PRIORITY_MAP[priorityName];
+  }
+
   // Handle append
   if (opts.append || opts.a) {
     const currentResult = await gql(`{ issue(id: "${issueId}") { description } }`);
@@ -702,6 +895,70 @@ async function cmdIssueUpdate(args) {
     input.description = opts.description || opts.d;
   }
 
+  // Handle check/uncheck
+  const checkText = opts.check;
+  const uncheckText = opts.uncheck;
+  if (checkText || uncheckText) {
+    const isCheck = !!checkText;
+    const query = checkText || uncheckText;
+    const fromPattern = isCheck ? /- \[ \] / : /- \[x\] /i;
+    const toMark = isCheck ? '- [x] ' : '- [ ] ';
+    const verb = isCheck ? 'Checked' : 'Unchecked';
+
+    // Fetch current description if we haven't already
+    let desc = input.description;
+    if (!desc) {
+      const currentResult = await gql(`{ issue(id: "${issueId}") { description } }`);
+      desc = currentResult.data?.issue?.description || '';
+    }
+
+    const lines = desc.split('\n');
+    const checkboxLines = lines
+      .map((line, i) => ({ line, index: i }))
+      .filter(({ line }) => fromPattern.test(line));
+
+    if (checkboxLines.length === 0) {
+      console.error(colors.red(`Error: No ${isCheck ? 'unchecked' : 'checked'} items found in description`));
+      process.exit(1);
+    }
+
+    // Find best match: score each checkbox line by similarity to query
+    const queryLower = query.toLowerCase();
+    let bestMatch = null;
+    let bestScore = 0;
+
+    for (const { line, index } of checkboxLines) {
+      const text = line.replace(/- \[[ x]\] /i, '').toLowerCase();
+      // Exact match
+      if (text === queryLower) { bestMatch = { line, index }; bestScore = Infinity; break; }
+      // Substring match
+      if (text.includes(queryLower) || queryLower.includes(text)) {
+        const score = queryLower.length / Math.max(text.length, queryLower.length);
+        if (score > bestScore) { bestScore = score; bestMatch = { line, index }; }
+      } else {
+        // Word overlap scoring
+        const queryWords = queryLower.split(/\s+/);
+        const textWords = text.split(/\s+/);
+        const overlap = queryWords.filter(w => textWords.some(tw => tw.includes(w) || w.includes(tw))).length;
+        const score = overlap / Math.max(queryWords.length, textWords.length);
+        if (score > bestScore) { bestScore = score; bestMatch = { line, index }; }
+      }
+    }
+
+    if (!bestMatch || bestScore < 0.3) {
+      console.error(colors.red(`Error: No checkbox matching "${query}"`));
+      console.error('Available items:');
+      checkboxLines.forEach(({ line }) => console.error('  ' + line.trim()));
+      process.exit(1);
+    }
+
+    lines[bestMatch.index] = bestMatch.line.replace(fromPattern, toMark);
+    input.description = lines.join('\n');
+
+    const itemText = bestMatch.line.replace(/- \[[ x]\] /i, '').trim();
+    console.log(colors.green(`${verb}: ${itemText}`));
+  }
+
   // Handle state
   if (opts.state || opts.s) {
     const stateName = opts.state || opts.s;
@@ -953,21 +1210,38 @@ async function cmdProjects(args) {
     projects = projects.filter(p => !['completed', 'canceled'].includes(p.state));
   }
 
+  // Find alias for a project (name must start with alias target)
+  const findAliasFor = (name) => {
+    const lowerName = name.toLowerCase();
+    let bestMatch = null;
+    let bestLength = 0;
+    for (const [code, aliasName] of Object.entries(ALIASES)) {
+      const lowerAlias = aliasName.toLowerCase();
+      // Name must start with the alias target, and prefer longer matches
+      if (lowerName.startsWith(lowerAlias) && lowerAlias.length > bestLength) {
+        bestMatch = code;
+        bestLength = lowerAlias.length;
+      }
+    }
+    return bestMatch;
+  };
+
   console.log(colors.bold('Projects:\n'));
-  const rows = projects.map(p => [
-    p.name,
-    p.state,
-    `${Math.floor(p.progress * 100)}%`
-  ]);
+  const rows = projects.map(p => {
+    const alias = findAliasFor(p.name);
+    const nameCol = alias ? `${colors.bold(`[${alias}]`)} ${p.name}` : p.name;
+    return [nameCol, p.state, `${Math.floor(p.progress * 100)}%`];
+  });
   console.log(formatTable(rows));
 }
 
 async function cmdProjectShow(args) {
-  const projectName = args[0];
-  if (!projectName) {
+  const projectNameArg = args[0];
+  if (!projectNameArg) {
     console.error(colors.red('Error: Project name required'));
     process.exit(1);
   }
+  const projectName = resolveAlias(projectNameArg);
 
   const query = `{
     team(id: "${TEAM_KEY}") {
@@ -982,7 +1256,7 @@ async function cmdProjectShow(args) {
 
   const result = await gql(query);
   const projects = result.data?.team?.projects?.nodes || [];
-  const project = projects.find(p => p.name.includes(projectName));
+  const project = projects.find(p => p.name.toLowerCase().includes(projectName.toLowerCase()));
 
   if (!project) {
     console.error(colors.red(`Project not found: ${projectName}`));
@@ -1129,34 +1403,58 @@ async function cmdMilestones(args) {
     projects = projects.filter(p => !['completed', 'canceled'].includes(p.state));
   }
 
-  // Filter by project name if specified
+  // Filter by project name if specified (resolve alias first)
   if (projectFilter) {
-    projects = projects.filter(p => p.name.toLowerCase().includes(projectFilter.toLowerCase()));
+    const resolvedFilter = resolveAlias(projectFilter);
+    projects = projects.filter(p => p.name.toLowerCase().includes(resolvedFilter.toLowerCase()));
   }
 
+  // Find alias for a name (name must start with alias target)
+  const findAliasFor = (name) => {
+    const lowerName = name.toLowerCase();
+    let bestMatch = null;
+    let bestLength = 0;
+    for (const [code, aliasName] of Object.entries(ALIASES)) {
+      const lowerAlias = aliasName.toLowerCase();
+      // Name must start with the alias target, and prefer longer matches
+      if (lowerName.startsWith(lowerAlias) && lowerAlias.length > bestLength) {
+        bestMatch = code;
+        bestLength = lowerAlias.length;
+      }
+    }
+    return bestMatch;
+  };
+
   console.log(colors.bold('Milestones:\n'));
   for (const project of projects) {
     const milestones = project.projectMilestones?.nodes || [];
     if (milestones.length === 0) continue;
 
-    console.log(colors.bold(project.name));
+    const projectAlias = findAliasFor(project.name);
+    const projectHeader = projectAlias
+      ? `${colors.bold(`[${projectAlias}]`)} ${colors.bold(project.name)}`
+      : colors.bold(project.name);
+    console.log(projectHeader);
     for (const m of milestones) {
+      const milestoneAlias = findAliasFor(m.name);
+      const namePrefix = milestoneAlias ? `${colors.bold(`[${milestoneAlias}]`)} ` : '';
       const date = m.targetDate ? ` (${m.targetDate})` : '';
       const status = m.status !== 'planned' ? ` [${m.status}]` : '';
-      console.log(`  ${m.name}${date}${status}`);
+      console.log(`  ${namePrefix}${m.name}${date}${status}`);
     }
     console.log('');
   }
 }
 
 async function cmdMilestoneShow(args) {
-  const milestoneName = args[0];
-  if (!milestoneName) {
+  const milestoneNameArg = args[0];
+  if (!milestoneNameArg) {
     console.error(colors.red('Error: Milestone name required'));
     process.exit(1);
   }
+  const milestoneName = resolveAlias(milestoneNameArg);
 
-  const query = `{
+  const projectsQuery = `{
     team(id: "${TEAM_KEY}") {
       projects(first: 50) {
         nodes {
@@ -1164,7 +1462,6 @@ async function cmdMilestoneShow(args) {
           projectMilestones {
             nodes {
               id name description targetDate status sortOrder
-              issues { nodes { identifier title state { name type } } }
             }
           }
         }
@@ -1172,8 +1469,23 @@ async function cmdMilestoneShow(args) {
     }
   }`;
 
-  const result = await gql(query);
-  const projects = result.data?.team?.projects?.nodes || [];
+  const issuesQuery = `{
+    team(id: "${TEAM_KEY}") {
+      issues(first: 200) {
+        nodes {
+          identifier title state { name type }
+          projectMilestone { id }
+        }
+      }
+    }
+  }`;
+
+  const [projectsResult, issuesResult] = await Promise.all([
+    gql(projectsQuery),
+    gql(issuesQuery)
+  ]);
+  const projects = projectsResult.data?.team?.projects?.nodes || [];
+  const allIssues = issuesResult.data?.team?.issues?.nodes || [];
 
   let milestone = null;
   let projectName = '';
@@ -1199,7 +1511,7 @@ async function cmdMilestoneShow(args) {
   if (milestone.targetDate) console.log(`Target: ${milestone.targetDate}`);
   if (milestone.description) console.log(`\n## Description\n${milestone.description}`);
 
-  const issues = milestone.issues?.nodes || [];
+  const issues = allIssues.filter(i => i.projectMilestone?.id === milestone.id);
   if (issues.length > 0) {
     // Group by state type
     const done = issues.filter(i => i.state.type === 'completed');
@@ -1910,6 +2222,77 @@ async function cmdLabelCreate(args) {
   }
 }
 
+// ============================================================================
+// ALIASES
+// ============================================================================
+
+async function cmdAlias(args) {
+  const opts = parseArgs(args, {
+    list: 'boolean', l: 'boolean',
+    remove: 'string', r: 'string',
+  });
+
+  const showList = opts.list || opts.l;
+  const removeCode = opts.remove || opts.r;
+  const code = opts._[0];
+  const name = opts._[1];
+
+  // List aliases
+  if (showList || (Object.keys(opts).length === 1 && opts._.length === 0)) {
+    const aliases = Object.entries(ALIASES);
+    if (aliases.length === 0) {
+      console.log('No aliases defined.');
+      console.log('Usage: linear alias CODE "Project or Milestone Name"');
+      return;
+    }
+
+    // Fetch projects to determine type (project vs milestone)
+    const query = `{
+      team(id: "${TEAM_KEY}") {
+        projects(first: 50) {
+          nodes { name }
+        }
+      }
+    }`;
+
+    const result = await gql(query);
+    const projects = result.data?.team?.projects?.nodes || [];
+
+    // Check if alias target matches a project (using partial match)
+    const matchesProject = (target) => {
+      const lowerTarget = target.toLowerCase();
+      return projects.some(p => p.name.toLowerCase().includes(lowerTarget));
+    };
+
+    console.log(colors.bold('Aliases:\n'));
+    for (const [code, target] of aliases) {
+      const isProject = matchesProject(target);
+      const type = isProject ? colors.blue('project') : colors.yellow('milestone');
+      console.log(`  ${colors.bold(code)} -> ${target} (${type})`);
+    }
+    return;
+  }
+
+  // Remove alias
+  if (removeCode) {
+    removeAlias(removeCode);
+    console.log(colors.green(`Removed alias: ${removeCode.toUpperCase()}`));
+    return;
+  }
+
+  // Create/update alias
+  if (!code || !name) {
+    console.error(colors.red('Error: Code and name required'));
+    console.error('Usage: linear alias CODE "Project or Milestone Name"');
+    console.error('       linear alias --list');
+    console.error('       linear alias --remove CODE');
+    process.exit(1);
+  }
+
+  saveAlias(code, name);
+  console.log(colors.green(`Alias set: ${code.toUpperCase()} -> ${name}`));
+}
+
 // ============================================================================
 // GIT INTEGRATION
 // ============================================================================
@@ -2748,6 +3131,7 @@ ISSUES:
     --milestone <name>       Filter by milestone
     --state, -s <state>      Filter by state
     --label, -l <name>       Filter by label
+    --priority <level>       Filter by priority (urgent/high/medium/low/none)
   issues reorder <ids...>    Reorder issues by listing IDs in order
 
   issue show <id>            Show issue details with parent context
@@ -2760,6 +3144,7 @@ ISSUES:
     --parent <id>            Parent issue (for sub-issues)
     --assign                 Assign to yourself
     --estimate, -e <size>    Estimate: XS, S, M, L, XL
+    --priority <level>       Priority: urgent, high, medium, low, none
     --label, -l <name>       Add label
     --blocks <id>            This issue blocks another
     --blocked-by <id>        This issue is blocked by another
@@ -2769,7 +3154,10 @@ ISSUES:
     --state, -s <state>      New state
     --project, -p <name>     Move to project
     --milestone <name>       Move to milestone
+    --priority <level>       Set priority (urgent/high/medium/low/none)
     --append, -a <text>      Append to description
+    --check <text>           Check a checkbox item (fuzzy match)
+    --uncheck <text>         Uncheck a checkbox item (fuzzy match)
     --blocks <id>            Add blocking relation
     --blocked-by <id>        Add blocked-by relation
   issue close <id>           Mark issue as done
@@ -2816,6 +3204,15 @@ LABELS:
     --description, -d <desc> Label description
     --color, -c <hex>        Label color (e.g., #FF0000)
 
+ALIASES:
+  alias <CODE> "<name>"      Create alias for project/milestone
+  alias --list               List all aliases
+  alias --remove <CODE>      Remove an alias
+
+  Aliases can be used anywhere a project or milestone name is accepted:
+    linear issues --project LWW
+    linear issue create --milestone MVP "New feature"
+
 GIT:
   branch <id>                Create git branch from issue (ISSUE-5-issue-title)
 
@@ -2838,6 +3235,10 @@ CONFIGURATION:
     api_key=lin_api_xxx
     team=ISSUE
 
+    [aliases]
+    LWW=Last-Write-Wins Support
+    MVP=MVP Release
+
 EXAMPLES:
   linear roadmap             # See all projects and milestones
   linear issues --unblocked  # Find workable issues
@@ -2971,6 +3372,10 @@ async function main() {
         }
         break;
       }
+      case 'alias':
+        checkAuth();
+        await cmdAlias(args.slice(1));
+        break;
       case 'branch':
         checkAuth();
         await cmdBranch(args.slice(1));

package/claude/skills/linear-cli/SKILL.md

@@ -31,6 +31,45 @@ Config is loaded in order: `./.linear` → `~/.linear` → env vars
 # .linear file format
 api_key=lin_api_xxx
 team=ISSUE
+
+[aliases]
+V2=Version 2.0 Release
+MVP=MVP Milestone
+```
+
+## Aliases
+
+Create short codes for projects and milestones to use in commands:
+
+```bash
+# Create aliases
+linear alias V2 "Version 2.0"           # For a project
+linear alias MVP "MVP Milestone"        # For a milestone
+
+# List all aliases
+linear alias --list
+
+# Remove an alias
+linear alias --remove MVP
+```
+
+Use aliases anywhere a project or milestone name is accepted:
+
+```bash
+linear issues --project V2
+linear issues --milestone MVP
+linear issue create --project V2 --milestone MVP "New feature"
+linear milestones --project V2
+```
+
+Aliases are shown in `linear projects` and `linear milestones` output:
+
+```
+Projects:
+[V2] Version 2.0 Release  started  58%
+
+Milestones:
+[MVP] MVP Milestone [next]
 ```
 
 ## Quick Reference
@@ -53,15 +92,19 @@ linear issues --mine            # Only your assigned issues
 linear issues --project "Name"  # Issues in a project
 linear issues --milestone "M1"  # Issues in a milestone
 linear issues --label bug       # Filter by label
+linear issues --priority urgent # Filter by priority (urgent/high/medium/low/none)
 # Flags can be combined: linear issues --in-progress --mine
 linear issue show ISSUE-1        # Full details with parent context
 linear issue start ISSUE-1       # Assign to you + set In Progress
 linear issue create --title "Fix bug" --project "Phase 1" --assign --estimate M
+linear issue create --title "Urgent bug" --priority urgent --assign
 linear issue create --title "Task" --milestone "Beta" --estimate S
 linear issue create --title "Blocked task" --blocked-by ISSUE-1
 linear issue update ISSUE-1 --state "In Progress"
+linear issue update ISSUE-1 --priority high   # Set priority
 linear issue update ISSUE-1 --milestone "Beta"
 linear issue update ISSUE-1 --append "Notes..."
+linear issue update ISSUE-1 --check "validation" # Check off a todo item
 linear issue update ISSUE-1 --blocks ISSUE-2  # Add blocking relation
 linear issue close ISSUE-1
 linear issue comment ISSUE-1 "Comment text"
@@ -90,6 +133,12 @@ linear issue move ISSUE-5 --before ISSUE-1       # Move single issue
 linear labels                   # List all labels
 linear label create "bug" --color "#FF0000"
 
+# Aliases
+linear alias V2 "Version 2.0"        # Create alias for project/milestone
+linear alias --list                  # List all aliases
+linear alias --remove V2             # Remove alias
+# Then use: linear issues --project V2
+
 # Git
 linear branch ISSUE-1            # Create branch: ISSUE-1-issue-title
 ```
@@ -174,6 +223,26 @@ linear issue create --title "Step 3: Add tests" --parent ISSUE-5 --estimate S
 linear issue start ISSUE-6
 ```
 
+### Checklists vs. sub-issues
+Use description checklists for lightweight steps within a single issue. Use sub-issues when items need their own status, assignee, or estimate.
+
+```bash
+# Checklist — quick implementation steps, a punch list, acceptance criteria
+linear issue update ISSUE-5 --append "## TODO\n- [ ] Add validation\n- [ ] Update tests\n- [ ] Check edge cases"
+
+# Check off completed items (fuzzy matches the item text)
+linear issue update ISSUE-5 --check "validation"
+linear issue update ISSUE-5 --check "tests"
+
+# Uncheck if needed
+linear issue update ISSUE-5 --uncheck "validation"
+
+# Sub-issues — substantial, independently trackable work
+linear issue create --title "Add login endpoint" --parent ISSUE-5 --estimate S
+```
+
+Prefer checklists when the items are small and don't need independent tracking. Prefer sub-issues when you'd want to assign, estimate, or block on them individually. Use `--check` to mark items complete as you finish them.
+
 ### Completing work
 After finishing implementation, ask the developer if they want to close the issue:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dabble/linear-cli",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Linear CLI with unblocked issue filtering, built for AI-assisted development",
   "type": "module",
   "bin": {

package/postinstall.mjs

@@ -28,8 +28,7 @@ try {
   console.log(`\x1b[33m⚠\x1b[0m Could not install Claude files: ${err.message}`);
 }
 
-// Add linear permission to settings.json
-const PERMISSION = 'Bash(linear:*)';
+// Add permissions to settings.json
 const settingsPath = join(dest, 'settings.json');
 
 try {
@@ -43,11 +42,37 @@ try {
   settings.permissions = settings.permissions || {};
   settings.permissions.allow = settings.permissions.allow || [];
 
-  // Add permission if not already present
-  if (!settings.permissions.allow.includes(PERMISSION)) {
-    settings.permissions.allow.push(PERMISSION);
+  // Build list of permissions to add
+  const permissions = ['Bash(linear:*)'];
+
+  // Add Skill permissions for each skill in the skills directory
+  const skillsDir = join(src, 'skills');
+  if (existsSync(skillsDir)) {
+    const skills = readdirSync(skillsDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory())
+      .map((e) => e.name);
+
+    for (const skill of skills) {
+      permissions.push(`Skill(${skill})`);
+      permissions.push(`Skill(${skill}:*)`);
+    }
+  }
+
+  // Add permissions if not already present
+  const added = [];
+  for (const permission of permissions) {
+    if (!settings.permissions.allow.includes(permission)) {
+      settings.permissions.allow.push(permission);
+      added.push(permission);
+    }
+  }
+
+  if (added.length > 0) {
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-    console.log(`\x1b[32m✓\x1b[0m Added ${PERMISSION} to ~/.claude/settings.json`);
+    console.log(`\x1b[32m✓\x1b[0m Added permissions to ~/.claude/settings.json:`);
+    for (const permission of added) {
+      console.log(`  - ${permission}`);
+    }
   }
 } catch (err) {
   console.log(`\x1b[33m⚠\x1b[0m Could not update settings: ${err.message}`);