Skip to content

natehessler/lindesk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,354 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lindesk

AI-powered Plain ticket analysis that automatically creates Linear issues and posts summaries to Slack. Uses Sourcegraph Deep Search to intelligently interpret ticket context and generate actionable insights.

Features

  • 🎫 Analyzes Plain tickets with full conversation history
  • 🤖 AI-powered analysis with flexible, natural responses
  • 📋 Automatically creates Linear issues
  • 💬 Posts formatted summaries to Slack
  • 🌐 Modern web interface with dark mode + CLI
  • 🔍 Deep Search integration for codebase context
  • ⚙️ Web-based settings management

Prerequisites

  • Node.js 16+
  • API access: Plain, Sourcegraph, Slack (optional), Linear (optional)

Quick Start

# Install
npm install -g lindesk

# Configure
lindesk setup
PLAIN_API_KEY=your-plain-api-key
SOURCEGRAPH_URL=https://your-sourcegraph-instance.com
SOURCEGRAPH_TOKEN=your-sourcegraph-access-token
SLACK_TOKEN=xoxb-your-slack-bot-token  # Optional
DEFAULT_SLACK_CHANNEL=C0123ABC456  # Optional
LINEAR_API_KEY=your-linear-api-key  # Optional
DEFAULT_LINEAR_PROJECT=TEAM  # Optional

Usage

Web Interface (Recommended)

npm run web
# Open http://localhost:3000

Features:

  • Deep Search integration for contextual analysis
  • Interactive ticket analysis form with dark mode
  • Real-time results display
  • Web-based settings configuration

Command Line

# Analyze and post to Slack
lindesk ticket 12345 --channel C0123ABC456

# Create Linear issue
lindesk ticket 12345 --project ENG

# Both Slack and Linear
lindesk ticket 12345 --project ENG --channel C0123ABC456

# Custom analysis prompt
lindesk ticket 12345 "analyze root cause" --channel C0123ABC456

How It Works

  1. Fetches ticket details and conversation history from Plain
  2. Analyzes content using Sourcegraph Deep Search for comprehensive insights
  3. Generates structured analysis with root causes and solutions
  4. Creates Linear issue and/or posts to Slack with formatted summary

Configuration

Configure via web interface at http://localhost:3000/settings or run lindesk setup:

  • Plain: API key
  • Sourcegraph: Instance URL and access token for Deep Search analysis
  • Slack: Bot token (optional)
  • Linear: API key (optional)

For Slack setup, see SLACK_GUIDE.md.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors