Skip to content

README.md

Latest commit

 

History

History
73 lines (54 loc) · 2.41 KB

README.md

File metadata and controls

73 lines (54 loc) · 2.41 KB

superintent-vscode

VScode extension for Superintent. Manage projects, tmux sessions, track specs, ticket, and knowledge from your sidebar.

Features

Projects

  • Folder-based projects — Add any folder as a project via native folder dialog
  • Custom categories — Create, rename, and delete categories to organize projects
  • Drag and drop — Move projects between categories and reorder within them
  • Open in New Window — Right-click to launch a project in a new VS Code window
  • Local persistence — Data stored in VS Code globalState, no server needed

Tmux Management

  • Visual session control — Create, rename, delete sessions/windows/panes via context menus
  • Local & Remote grouping — Sessions auto-categorized by naming convention (-remote suffix)
  • Split & resize panes — Horizontal/vertical splits and size adjustments
  • Status bar integration — See active session at a glance
  • Mouse mode toggle — Enable/disable mouse scrolling with one click

Tickets

  • Kanban-style tree view — Backlog, In Progress, In Review, Done
  • Drag and drop — Move tickets between statuses
  • Rich preview — View full ticket details in a webview panel

Knowledge

  • Categorized entries — Architecture, patterns, truths, principles, gotchas
  • Active/inactive tracking — Deactivated knowledge sorted to end of list

Specs

  • Feature specs — Track and preview specs from your sidebar

Requirements

  • Bun runtime
  • tmux installed on local machine (for tmux features)
  • Superintent server running for tickets, knowledge, and specs

Development

# Install dependencies
bun install

# Build
bun run build

# Watch mode
bun run watch

# Lint & format (Biome)
bun run check        # run all checks (format + lint)
bun run check:fix    # fix all auto-fixable issues
bun run lint         # lint only
bun run lint:fix     # lint and fix
bun run format       # check formatting
bun run format:fix   # fix formatting

# Package extension
bun run package

Quick Start

  1. Click the Superintent icon in the activity bar
  2. Projects — Click + to create a category, then right-click to add project folders
  3. Tmux — Expand Local/Remote groups to manage sessions
  4. Tickets/Knowledge/Specs — Configure server URL in settings, data syncs via SSE
  5. Right-click on any item for available actions

License

MIT