Polaris is a taskchain orchestration framework for governed AI agent workflows. It dispatches, tracks, and finalizes implementation work across AI providers — keeping every run bounded, auditable, and connected to your issue tracker.

Install

npm install -g @lsctech/polaris

Requires Node.js 22+.

Quick Start

# Initialize Polaris in your repository
polaris init --adopt

# Check configuration
polaris doctor

# Start a governed run
polaris run POL-123

# Check status
polaris status

# Finalize completed work
polaris finalize

Configuration

Polaris is configured via polaris.config.json at the repository root.

{
  "version": "1.0",
  "repo": {
    "name": "my-project",
    "sourceRoots": ["src"]
  },
  "tracker": {
    "adapter": "github",
    "github": {
      "enabled": true,
      "owner": "my-org",
      "repo": "my-project",
      "labelPrefix": "status:"
    }
  }
}

Tracker Adapters

| Adapter | Description | |---|---| | github | GitHub Issues — label-based lifecycle states, PAT auth | | linear | Linear — team/project scoped, API key auth | | jira | Jira Cloud — REST API v3, Basic auth | | local | Local file graph only, no external sync |

Set credentials via environment variables:

export GITHUB_TOKEN=ghp_...
export LINEAR_API_KEY=lin_api_...
export JIRA_API_TOKEN=your_token

Documentation

• Setup Guide — Installation, tracker configuration, environment variables
• Usage Guide — Daily workflow, commands, configuration reference, troubleshooting

License

MIT — © LSC Technologies