{"id":28436206,"url":"https://github.com/zephraph/linear-agent","last_synced_at":"2025-06-27T18:31:57.564Z","repository":{"id":293419248,"uuid":"983205181","full_name":"zephraph/linear-agent","owner":"zephraph","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-16T19:59:31.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-05T21:47:29.435Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zephraph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-14T03:29:37.000Z","updated_at":"2025-05-16T19:59:30.000Z","dependencies_parsed_at":"2025-05-15T08:53:14.151Z","dependency_job_id":null,"html_url":"https://github.com/zephraph/linear-agent","commit_stats":null,"previous_names":["zephraph/linear-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zephraph/linear-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zephraph%2Flinear-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zephraph%2Flinear-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zephraph%2Flinear-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zephraph%2Flinear-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zephraph","download_url":"https://codeload.github.com/zephraph/linear-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zephraph%2Flinear-agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262311040,"owners_count":23291670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-05T21:35:43.373Z","updated_at":"2025-06-27T18:31:57.539Z","avatar_url":"https://github.com/zephraph.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Linear Agent Demo\n\nA demonstration of building AI agents that interact with Linear issues using OpenAI. This project showcases how to build intelligent agents that can respond to mentions and perform research tasks within Linear.\n\nThis is demoware and should _not_ be used in production. Be careful!\n\n## 🚀 Quick Start\n\nThis project uses [`mise`](https://mise.jdx.dev/) for managing development tools and environment variables. Make sure you have it installed first.\n\n```bash\n# Install mise if you haven't already\ncurl https://mise.run | sh\n\n# Setup your development environment\nmise install\n\n# Add local domain to hosts file (requires sudo)\necho \"127.0.0.1 linear.agent\" | sudo tee -a /etc/hosts\n\n# Start the development server\nmise run dev\n```\n\n## 📁 Project Structure\n\nThe most important directory to look at is `src/agents/`. This is where all the Linear agents are defined:\n\n- `ResearchAgent.ts`: An AI agent that responds to mentions in Linear issues by performing research using GPT-4 and web search capabilities.\n\n## 🔧 Available Tasks\n\nAll tasks are managed through `mise`:\n\n- `mise run dev` - Start the development server with debug logging\n- `mise run start` - Start the production server\n- `mise run generate-certs` - Generate SSL certificates for local development\n- `mise run db:generate` - Generate database schemas\n- `mise run db:migrate` - Run database migrations\n\n## 🔐 Environment Setup\n\nThe project uses a `.env` file for configuration. The `mise run setup` will copy the `.env.example` to `.env`. You'll just need to fill in the values. All environment variables above are required for the application to function properly. You can obtain the Linear credentials by creating a Linear OAuth application in your workspace settings.\n\nEnvironment variables are validated in [`src/lib/env.ts`](src/lib/env.ts).\n\n## 🔑 Authentication\n\nThis project uses [`better-auth`](https://github.com/better-auth/better-auth) for handling the OAuth flow with Linear. \n\n## 🔒 Security Note\n\nThis project uses self-signed certificates for local development. \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzephraph%2Flinear-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzephraph%2Flinear-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzephraph%2Flinear-agent/lists"}