Lineary is project management rebuilt from the ground up for the AI era. Designed for software development teams who want to harness AI to ship faster and smarter.
- 🤖 AI-Native: Built with AI at its core, not bolted on
- 🔒 Privacy-First: Self-hosted, your data stays yours
- 🎯 Developer-Focused: Built by developers, for developers
- 💰 Forever Free: Community Edition is free for teams up to 5 users
- 🔌 Extensible: Rich integration ecosystem with GitHub, GitLab, Slack, and more
Lineary implements a complete AI-powered development cycle that learns and improves with every iteration:
LLM (Claude/AI) → Lineary (Tasks) → Git (Code) → Claude Review → Lineary (Insights) → AI Learning
How it works:
- AI creates tasks with time estimates in Lineary
- Developers work on tasks and create PRs (must reference issue #123)
- Claude automatically reviews every PR for quality, security, and performance
- Lineary tracks actual vs estimated time
- AI learns from the data to improve future estimates
- System gets smarter with every completed task
- Projects & Issues - Organize work with unlimited projects and issues
- Sprint Planning - AI-assisted sprint planning and management
- Kanban Boards - Visual task management with drag-and-drop
- Activity Tracking - Complete audit trail of all changes
- Comments & Collaboration - Team discussions on every issue
- Smart Story Points - AI-powered estimation based on issue complexity
- Claude Code Reviews - Automatic AI code review on every PR
- AI Learning Loop - Improves estimation accuracy over time (typically 5-10% per sprint)
- Test Generation - Automatic Gherkin test case creation
- Issue Breakdown - Split large tasks into manageable subtasks
- Autonomous Runners - Headless Claude Code / Codex / OpenCode dispatch for
auto_handleissues — opens PRs without human babysitting. See runner/README.md.
- Automatic PR Reviews - Claude reviews every pull request
- PR-to-Issue Sync - Automatic linking and status updates
- Code Quality Metrics - Track quality trends over time
- Security Detection - Identify vulnerabilities before merge
- Performance Analysis - Catch performance issues early
- Learning Insights - AI improves with every review
- GitHub App - Full webhook integration with Claude AI reviews
- GitHub OAuth - Repository access and user authentication
- GitLab - Complete GitLab integration
- BitBucket - Repository sync and PR tracking
- Slack - Real-time notifications and commands
- Notion - Bi-directional page synchronization
- MCP Server - Claude Desktop integration for AI-assisted development
- REST API - Comprehensive API for automation
- Webhooks - Real-time event notifications
- CLI Tool - Command-line interface for power users
- Runner Daemon - Node 18+ binary (no npm deps) that long-polls Lineary and executes coding agents in a scratch git worktree. Ship autonomous bug-fix loops end-to-end.
Flag any issue with auto_handle=true and a registered runner on your laptop/homelab/NAS will:
- Long-poll Lineary for pending dispatches (outbound HTTPS, no inbound ports).
git worktree adda new branch in your project clone.- Spawn headless Claude Code (
claude -p), Codex (codex exec), or OpenCode (opencode run) with the issue body as the prompt. - Stream stdout live into the issue detail view (SSE).
git push+gh pr createon success — your existing CI runs and the GitHub ↔ Lineary sync closes the issue when it passes.
Wire a CI workflow failure to auto-create an auto_handle issue (.github/workflows/ci-to-lineary.yml) and you have a self-healing loop: red build → issue → runner → PR → green.
Install: Account → Runners → Register → paste ~/.lineary/runner.json → node runner/lineary-runner.js. Full docs in runner/README.md.
curl -sSL https://get.lineary.com | sh- Clone the repository
git clone https://github.com/lineary/lineary-community.git
cd lineary-community- Configure environment
cp .env.example .env
# Edit .env with your settings- Start with Docker Compose
docker-compose up -d- Access Lineary
http://localhost:3000
Default credentials:
- Username:
admin - Password:
changeme
Prerequisites:
- Node.js 18+
- PostgreSQL 14+ or SQLite
- Redis (optional, for caching)
Steps:
# Clone repository
git clone https://github.com/lineary/lineary-community.git
cd lineary-community
# Install backend dependencies
cd backend
npm install
# Install frontend dependencies
cd ../frontend
npm install
# Build frontend
npm run build
# Initialize database
cd ../backend
npm run db:migrate
# Start services
npm run start:prodSetting up the GitHub App enables automatic Claude AI code reviews on every PR:
- Go to GitHub Settings → Developer settings → GitHub Apps
- Click New GitHub App
- Configure with these settings:
- Name:
Lineary-Claude-Reviewer(must be unique) - Homepage URL: Your Lineary URL
- Webhook URL:
https://your-lineary-domain/api/github/webhook - Webhook secret: Generate and save a strong secret
- Name:
Repository permissions:
- Contents: Read
- Issues: Write
- Pull requests: Write
- Metadata: Read
Subscribe to events:
- Pull request
- Pull request review comment
- Push
- After creating the app, scroll to "Private keys"
- Click "Generate a private key"
- Save the
.pemfile securely
Add to your .env:
# GitHub App Configuration
GITHUB_APP_ID=your_app_id
GITHUB_PRIVATE_KEY_PATH=./github-app-private-key.pem
GITHUB_WEBHOOK_SECRET=your_webhook_secret
# Claude AI Configuration
ANTHROPIC_API_KEY=your_anthropic_api_key
# GitHub OAuth (for user authentication)
GITHUB_CLIENT_ID=your_oauth_client_id
GITHUB_CLIENT_SECRET=your_oauth_client_secret- Go to your GitHub App settings
- Click "Install App"
- Choose repositories to enable Claude reviews
Every commit and PR MUST reference the Lineary issue:
# Correct - enables AI cycle
git commit -m "feat: Add authentication #123"
git commit -m "fix: Memory leak in parser LIN-456"
# Wrong - breaks automation
git commit -m "Add authentication" # No tracking!Without issue references, you lose:
- Automatic PR tracking
- Claude code reviews with context
- AI learning from actual time
- Sprint velocity calculations
-
Create a Slack App:
- Go to api.slack.com/apps
- Create new app
- Add OAuth scopes:
chat:write,commands
-
Add credentials to
.env:
SLACK_CLIENT_ID=your_client_id
SLACK_CLIENT_SECRET=your_client_secret
SLACK_SIGNING_SECRET=your_signing_secretSee full integration guides in our documentation.
Track how the AI improves over time:
- Initial: ~60% accuracy (typical for new projects)
- After 10 tasks: ~70% accuracy
- After 50 tasks: ~80% accuracy
- After 100 tasks: ~85-90% accuracy
The Claude AI reviewer improves by learning from:
- Code patterns in your project
- Common issues in your codebase
- Your team's coding standards
- Historical bug patterns
Access insights at /analytics in your Lineary instance:
- Code Quality Trend: Track quality scores over time
- Security Issues: Monitor security vulnerabilities found
- Performance Metrics: See performance issue trends
- AI Accuracy: View estimation accuracy improvements
- Sprint Velocity: Track team velocity with AI-adjusted estimates
Note: Detailed documentation is available for enterprise customers. Community users can access:
We love contributions! Lineary is a community-driven project and we welcome developers of all skill levels.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
# Clone your fork
git clone https://github.com/YOUR_USERNAME/lineary-community.git
cd lineary-community
# Install dependencies
npm run install:all
# Start development servers
npm run dev
# Run tests
npm run test
# Run linting
npm run lint- Code Style: We use ESLint and Prettier
- Commits: Follow conventional commits specification
- Tests: Write tests for new features
- Documentation: Update docs for API changes
- Issues: Check existing issues before creating new ones
Looking for something to work on? Check out our good first issues.
- ✅ Core project management
- ✅ AI features
- ✅ GitHub/GitLab integration
- 🚧 BitBucket integration
- 🚧 Slack integration
- 🚧 Notion sync
- 📋 Plugin system
- 📋 Theme support
- 📋 Mobile app
- Advanced AI models (GPT-4, Claude 3)
- Unlimited users
- Jira/ClickUp integration
- SSO/SAML support
- 24/7 Priority support
- SLA guarantees
- Custom development
- GitHub Discussions: github.com/lineary/community/discussions
- Discord: discord.gg/lineary
- Twitter: @lineary
- Stack Overflow: Tag
lineary
- Bugs: GitHub Issues
- Security: security@lineary.com
- Feature Requests: Discussions
Need more than 5 users? Advanced features? Professional support?
Lineary Enterprise includes:
- Unlimited users
- Advanced AI models
- Jira/ClickUp integration
- 24/7 Priority support
- SLA guarantees
- Custom development
Learn more about Enterprise | Contact Sales
Lineary Community Edition is licensed under the MIT License - see the LICENSE file for details.
This means you can:
- ✅ Use commercially
- ✅ Modify
- ✅ Distribute
- ✅ Use privately
Lineary is built on the shoulders of giants:
- React - UI Framework
- Node.js - Backend runtime
- PostgreSQL - Database
- Docker - Containerization
- TypeScript - Type safety
- Tailwind CSS - Styling
Special thanks to all our contributors!
Ready to transform your project management with AI?
git clone https://github.com/lineary/lineary-community.git
cd lineary-community
docker-compose up -dVisit http://localhost:3000 and start managing projects smarter!