spec-kitty-tracker

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 on this page — 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

spec-kitty-tracker on PyPI

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

Evidence: spec_kitty_tracker-0.4.3-py3-none-any.whl

Tags

More Application Frameworks packages