| Released | 2019 |
|---|---|
| Developed by | Linear |
| Type | Tool |
| Aliases | Linear app, Linear.app |
| Related | 워크스페이스 에이전트, Codex (OpenAI), 컴퓨터 사용 (에이전트), 역할 기반 접근 통제 (RBAC) |
무엇인가
Linear는 소프트웨어 팀이 작업을 관리하기 위해 쓰는 이슈 트래커다. Jira나 GitHub Issues와 같은 범주의 도구지만, 빠른 키보드 단축키와 정돈된 화면, 빠른 응답 속도를 무기로 스타트업과 제품 개발팀 사이에서 빠르게 자리를 잡았다.
무엇을 할 수 있는가
각 작업은 "이슈"라는 카드 형태로 만들어지고, 담당자·상태·우선순위·마감일·관련 프로젝트 같은 속성을 갖는다. 팀은 사이클(보통 1~2주짜리 스프린트)이나 프로젝트 단위로 이슈를 묶어 진행 상황을 추적한다. 댓글, 첨부, GitHub PR 연결 같은 협업 기능도 기본 제공된다.
왜 AI 기사에서 자주 보이는가
요즘 AI 에이전트 시연에서 Linear는 단골 손님이다. [[workspace-agents]]나 [[codex]] 같은 에이전트가 사람처럼 일한다는 걸 보여줄 때 "에이전트가 코드 변경을 만들고 자동으로 Linear에 이슈를 등록해 동료에게 할당한다"는 식의 시나리오가 반복된다. Linear의 공개 API가 깔끔하고, 개발팀이 매일 쓰는 친숙한 인터페이스라는 두 가지 이유가 겹친다. 즉 "에이전트가 일을 잘한다"는 인상을 가장 빠르게 전달할 수 있는 무대인 셈이다.
비슷한 도구와의 차이
Jira가 엔터프라이즈의 복잡한 워크플로우를 다루는 데 강하다면, Linear는 "작은 팀의 빠른 흐름"에 최적화돼 있다. GitHub Issues보다 정돈된 프로젝트 관리 기능을, Asana보다 개발자 친화적인 인터페이스를 제공한다. 그래서 모던 SaaS 스타트업과 AI 인프라 회사들이 많이 채택했고, 이런 회사들이 다시 자사 에이전트 데모에서 Linear를 예로 드는 순환 구조가 만들어졌다.
어떻게 시작하는가
linear.app 에서 무료 워크스페이스를 만들 수 있다. 처음에는 한두 개 팀과 사이클을 세팅하고, 이슈 몇 개를 만들어 단축키(C로 새 이슈, Cmd+K로 명령 팔레트)에 익숙해지는 것부터 시작하면 된다.
핵심 기능
Linear는 이슈, 프로젝트, 사이클, 트리아지 큐, 로드맵 다섯 가지 개념을 중심으로 작동한다. 이슈는 가장 작은 단위, 프로젝트는 여러 이슈를 묶는 배송 가능한 결과물, 사이클은 시간 박스, 트리아지는 새로 들어온 이슈가 분류 대기하는 인박스다. 키보드 단축키 중심 UX 덕분에 마우스 없이도 대부분의 작업이 가능하다.
GraphQL API
Linear의 API는 GraphQL이다. api.linear.app/graphql 단일 엔드포인트에 인터랙티브 익스플로러가 함께 제공되고, 모든 엔티티(Issue, Project, Cycle, User, Comment 등)를 같은 곳에서 쿼리·변경할 수 있다. 인증은 개인용 API 키(PAT) 또는 OAuth 2.0이며, 사용자를 대신해 이슈를 만드는 봇·에이전트는 OAuth가 권장된다. 이슈 생성은 issueCreate 뮤테이션 한 번이면 끝난다.
웹훅과 실시간 이벤트
상태 변경, 새 댓글, 새 이슈 등에 대해 웹훅을 등록할 수 있다. Linear는 자체 실시간 동기화 프로토콜도 운영하지만, 외부 통합에서는 보통 웹훅으로 충분하다. 페이로드는 액션 타입과 데이터 객체로 구성되며, 서명 검증 헤더가 함께 온다.
에이전트 통합 패턴
[[workspace-agents]]나 [[codex]] 같은 도구가 Linear와 통합될 때 흔한 패턴은 셋이다.
- 이슈 생성: 에이전트가 작업 분석을 마치고 사람이 이어받을 일을 이슈로 등록.
- 상태 업데이트: 에이전트가 PR을 만들고 관련 이슈의 상태를 "In Review"로 전환.
- 컨텍스트 조회: 에이전트가 사용자의 현재 사이클 이슈 목록을 읽어 우선순위를 결정.
이 패턴이 가능한 이유는 Linear의 데이터 모델이 일관되고, GraphQL 스키마가 잘 정의돼 LLM 도구 호출 명세를 자동 생성하기 쉬워서다.
운영 시 주의점
API에는 분당·시간당 레이트 리미트가 있고, OAuth 토큰은 워크스페이스 단위 권한이 묶이므로 다중 워크스페이스 에이전트는 토큰 분리가 필요하다. 또한 Linear는 휴지통 보관 기간이 짧아, 에이전트가 잘못 만든 이슈를 빨리 정리하지 않으면 노이즈가 쌓인다. 운영 환경에서는 에이전트 전용 OAuth 앱을 별도로 등록해 사람의 활동과 구분 가능하게 만드는 것이 권장된다.
시스템 개요
Linear는 2019년 출시된 SaaS 이슈 트래커로, 이슈·프로젝트·사이클을 정점(vertex)으로 하는 그래프 데이터 모델 위에 구축돼 있다. 클라이언트는 자체 동기화 프로토콜을 통해 로컬 캐시와 서버 상태를 실시간 일치시키며, 이는 사용자 체감 응답 속도의 핵심 차별점이다.
API 표면
공개 API는 GraphQL 단일 엔드포인트(api.linear.app/graphql)다. 스키마는 약 100여 개의 객체 타입으로 구성되며, 핵심 엔티티는 Issue, Project, Cycle, Team, WorkflowState, Label, User다. 인증은 PAT(Personal API Key) 또는 OAuth 2.0 Authorization Code Flow를 지원하며, OAuth 스코프는 read, write, admin, issues:create, comments:create 등 세분화돼 있다.
대부분의 변경 작업은 <entity>Create, <entity>Update, <entity>Delete 뮤테이션으로 통일돼 있어, LLM 함수 호출 명세를 자동 생성하기에 적합하다. 이런 일관된 명명 규칙은 도구 호출 정확도(tool-use accuracy)를 측정하는 비공식 벤치마크에서 Linear가 자주 채택되는 이유 중 하나다.
에이전트 통합에서의 역할
[[codex]], [[workspace-agents]], [[computer-use]] 등 최근 1년간 등장한 주요 에이전트 시스템 데모에서 Linear는 "타깃 SaaS"로 빈번히 호출된다. 이는 다음 세 가지가 결합한 결과로 보인다.
- API의 일관성과 GraphQL의 introspection 능력 — 에이전트가 도구 명세를 자동으로 발견·검증할 수 있다.
- 개발팀이 매일 쓰는 도구이므로, 데모 시청자가 결과를 즉시 이해한다.
- Linear 자체가 AI 친화적 UX(자연어 이슈 생성, AI 요약 등)를 적극 도입하면서 에이전트 호출을 1급 시민으로 다룬다.
특히 [[computer-use]] 계열 시연에서는 GUI 자동화가 Linear의 키보드 단축키와 자주 결합된다. 단축키 체계가 결정적이고 모달이 단순해, 시각 기반 에이전트가 실패할 확률이 다른 SaaS 대비 낮다.
한계와 연구적 함의
연구 측면에서 Linear는 "잘 정의된 SaaS 환경에서의 에이전트 도구 호출"을 평가하기엔 좋지만, 일반화에 한계가 있다. 첫째, GraphQL 스키마가 너무 깨끗해 실제 엔터프라이즈에서 마주치는 누더기 REST API의 어려움을 측정하지 못한다. 둘째, 단일 워크스페이스 단위 권한 모델은 [[role-based-access-control]] 같은 복잡한 다층 권한 시나리오를 시뮬레이션하기에 단순하다. 셋째, Linear는 비교적 작은 팀을 위한 도구이므로, 수십만 개 이슈를 다루는 환경에서의 에이전트 행동(검색·필터·페이지네이션 정확도)은 별도 검증이 필요하다.
또 하나의 연구적 관심사는 에이전트가 만든 이슈와 사람이 만든 이슈를 구분·추적하는 메타데이터 표준이다. Linear는 OAuth 앱 식별자를 통해 출처를 어느 정도 노출하지만, 멀티 에이전트가 동시에 같은 워크스페이스에 쓰는 환경에서는 감사·롤백을 위한 별도 메커니즘이 필요할 것으로 보인다.