用途：linearis 让你在 shell 中驱动 Linear.app，管理 issues/tickets、projects、cycles（sprints）等工作项，所有命令输出 JSON，便于脚本处理。命令为 linearis，linear 是别名。
主要能力：覆盖 issues、projects、cycles 等领域；支持创建、读取、讨论（discuss/discussions/replies/reply）、文件上传下载等操作。ID 较宽容，可传 UUID、团队 key（如 ENG）、issue 标识（如 ABC-123）或名称。输出可用全局 --fields identifier,title,state.name 与 --compact 在源头裁剪，复杂重塑再用 jq。
使用方式：先运行 linearis usage 获取领域列表，再运行 linearis <domain> usage 查看该领域的完整命令与参数参考，不要猜测命令面。未安装时可用 npm install -g linearis，或临时用 npx linearis@latest（有冷启动延迟且每次需联网）。认证需运行 linearis auth login，这是交互式浏览器流程，需用户自行完成。
限制与注意：认证失败会以 stderr 输出 AUTHENTICATION_REQUIRED 且退出码 42；无效调用退出码 2，错误类型包括 UNKNOWN_COMMAND、UNKNOWN_OPTION、MISSING_ARGUMENT 等，应依据返回的 available_commands 或 instruction 恢复。issues create 需要 --team，部分过滤需 scope 标志，以 usage 为准。顶层 comments 领域已弃用，建议用 issues discussion 命令。files download 仅能获取 Linear 存储 URL（uploads.linear.app）。版本检查可用 linearis version check，更新前应询问用户并遵循 channel。其余细节以 linearis <domain> usage 为准。