---
id: spec-kitty-tracker
version: "0.4.3"
license: MIT License Copyright (c) 2026 Spec Kitty Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# spec-kitty-tracker — Universal tracker interface, connector SDK, and sync engine for Spec Kitty

License: permissive · Maintenance: active · Downloads: 133.6K/mo

## What it is and what it does

spec-kitty-tracker is a connector SDK and sync engine that abstracts differences between multiple issue tracking systems. It defines a canonical issue model and tracker connector protocol with capability negotiation, allowing integrations across Linear, Jira, GitHub, GitLab, and other trackers without rewriting logic per platform. The package includes SaaS-backed connectors routed through hosted transport, local-first connectors for CLI tools, and an in-memory reference implementation.

The core value is the SyncEngine, which handles bidirectional issue synchronization with deterministic conflict resolution and source-of-truth ownership policies. Discovery functions enumerate workspaces and bindable resources across providers with a hybrid metadata contract that normalizes provider-native keys into optional standard fields.

Use it for:

- Build a SaaS platform that syncs issues bidirectionally between a user's Linear workspace and your internal tracking system.
- Migrate issues from one tracker to another while preserving external references and maintaining a source-of-truth policy.
- Integrate local CLI tools with cloud trackers by constructing connectors directly and using the SyncEngine.
- Discover and enumerate workspaces and projects across Linear, Jira, GitHub, and GitLab with a uniform metadata schema.
- Test tracker integrations without hitting live APIs using the InMemoryConnector reference implementation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a unified abstraction layer for connecting to multiple issue trackers with a canonical issue model, bidirectional sync engine, and connector registry.

Yes, if you need to integrate multiple issue trackers into a single application or sync engine. The abstraction layer and included connectors save significant development time. Requires Python 3.11+, httpx, and (for SaaS connectors) external Nango configuration. No known vulnerabilities. MIT license is permissive. Active maintenance and low install friction make it a solid choice for tracker integration work.

## Install

pip install spec-kitty-tracker
uv add spec-kitty-tracker
poetry add spec-kitty-tracker

## Installing spec-kitty-tracker

Before you install: Low install friction with a single runtime dependency (httpx). Actively maintained with latest release 109 days ago.

License in practice: MIT License permits commercial and private use, modification, and distribution with minimal restrictions—only requires retaining the license and copyright notice.

Quickstart:

pip install spec-kitty-tracker

from spec_kitty_tracker import create_hosted_connector, HostedConnectorRequest, LinearHostedParams, NangoConnectionContext, SyncEngine
import asyncio

async def main():
    nango_ctx = NangoConnectionContext(connection_id="user-connection-id", provider_config_key="linear", nango_secret_key="nango-secret")
    connector = create_hosted_connector(HostedConnectorRequest(provider="linear", nango_context=nango_ctx, params=LinearHostedParams(team_id="TEAM-UUID")))
    async with connector:
        await engine.pull()

asyncio.run(main())

Requires Python 3.11+. SaaS-backed connectors require Nango integration context (connection_id, provider_config_key, nango_secret_key) provided by the host platform.

Verify before relying:

- Whether SaaS-backed connectors require external API credentials or Nango setup beyond what the package provides.
- Performance characteristics and scalability limits for the SyncEngine with large issue volumes.
- Stability and feature completeness of AzureDevOpsConnector, listed as out of scope for hosted transport in this release.

## Package facts

- License: MIT License Copyright (c) 2026 Spec Kitty Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 133.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

issue tracker abstraction layer, multi-tracker sync engine, jira linear github connector, unified issue model, tracker connector protocol, bidirectional issue sync, task tracker integration, issue-tracking, connector-sdk, multi-provider

[View on SkillFed](https://skillfed.io/packages/spec-kitty-tracker) · [View on PyPI](https://pypi.org/project/spec-kitty-tracker/)