Skip to content

Releases: PrefectHQ/colin

v0.1.2: No Assembly Required

24 Jan 02:04
e4b5467

Choose a tag to compare

Fixes blueprint packaging so colin init -b quickstart works when installed from PyPI. Also fixes a dependency resolution issue with the FastMCP 3 beta.

What's Changed

Fixes 🐞

  • Fix fastmcp dependency for uv pip install by @jlowin in #150
  • Include all blueprint files in package build by @jlowin in #149

Full Changelog: v0.1.1...v0.1.2

v0.1.1: Blueprint for Success

23 Jan 22:07
83ecd38

Choose a tag to compare

This release adds the quickstart blueprint: a ready-to-run project that builds a skill from Colin's own documentation.

colin init using-colin -b quickstart
cd using-colin
colin run

The compiled skill contains the Colin quickstart, pulled live from GitHub. When we update the docs, your agent's knowledge of Colin updates too.

What's Changed

Docs 📚

  • Update README with team-status example and quickstart blueprint by @jlowin in #148

Full Changelog: v0.0.2...v0.1.1

v0.1.0: Colin All Agents

23 Jan 22:01
9b68b18

Choose a tag to compare

Colin is a context engine that compiles agent skills from live sources. Instead of writing static markdown files that drift from reality, you write templates that pull from GitHub repos, Linear issues, Notion pages, and other sources. Colin fetches the content, resolves dependencies between documents, and outputs compiled skills. When sources change, Colin detects it and rebuilds only what's stale.

The core insight is that agent skills are documentation, and documentation rots. The deployment guide you gave your agent last month doesn't match how deploys work today. Colin solves this by treating skills as compiled artifacts with tracked provenance—every skill knows what sources it came from and what versions were used.

What's in the initial release

  • 8 built-in providers: GitHub (files, issues, PRs), Linear, Notion, HTTP, S3, MCP servers, LLM, and project references
  • Incremental builds: Colin tracks source versions (commit SHAs, timestamps, hashes) and only recompiles what changed
  • LLM processing: Transform content with | llm_extract() filters or {% llm %} blocks, with automatic caching by input hash
  • Output targets: Write directly to Claude Code's skills folder, or any directory
  • Blueprints: Project templates for common patterns—including a quickstart blueprint that builds a skill from Colin's own documentation
  • Dependency tracking: ref() creates edges between documents; when one changes, dependents recompile

Colin is designed for teams that want their agents to have accurate, up-to-date context without manual maintenance. Point it at your actual sources of truth, run colin run, and your skills stay fresh.

What's Changed

New Features 🎉

  • Add mcp_prompt() function for MCP prompt templates by @jlowin in #1
  • Provider-contributed template functions by @jlowin in #33
  • Add HTTP provider and refactor provider interface by @jlowin in #37
  • Add classify() filter for LLM-based content classification by @jlowin in #40
  • Move LLM model config to [[providers.llm]] by @jlowin in #45
  • Add S3 provider and reorganize provider documentation by @jlowin in #46
  • JSON output with markdown-to-JSON conversion by @jlowin in #56
  • Add YAML output renderer by @jlowin in #57
  • Add instructions support for LLM provider by @jlowin in #80
  • Named sections with ref access by @jlowin in #83
  • Add defer blocks for self-referential documents by @jlowin in #86
  • Add project variables with typed configuration by @jlowin in #87
  • Implement strict static compilation model by @jlowin in #92
  • Add CLI banner with logo and project info by @jlowin in #108
  • Add {% file %} directive for multi-file output by @jlowin in #107
  • Add output targets and CLI improvements by @jlowin in #109
  • Add output() function for self-referencing templates by @jlowin in #122
  • Add colin run --update flag by @jlowin in #123
  • Add GitHub provider by @jlowin in #124
  • Add colin update command by @jlowin in #125
  • Add env var substitution and documentation overhaul by @jlowin in #126
  • Add colin skills update and improve colin clean by @jlowin in #128
  • Add template: false and colin-skill blueprint by @jlowin in #130
  • Add Notion provider by @jlowin in #132
  • Add colin skills list and colin status commands by @jlowin in #131
  • Add Linear provider and colin mcp auth clear command by @jlowin in #137
  • Add MCP skills consumer by @jlowin in #136
  • Add GitHub issues and PRs support by @jlowin in #144

Enhancements 🔧

  • Don't truncate meaningful operation names in CLI output by @jlowin in #2
  • Use project:// URI scheme for local document refs by @jlowin in #3
  • Use » icon for cached operations by @jlowin in #6
  • Improve LLM/extract display in CLI output by @jlowin in #7
  • Only allow UseExisting when previous output exists by @jlowin in #8
  • Add SKIPPED status for upstream dependency failures by @jlowin in #9
  • Improve CLI progress display with cleaner categories by @jlowin in #11
  • Replace --force flag with --no-cache by @jlowin in #27
  • Add pre-commit hook to prevent commits to main by @jlowin in #32
  • Add calendar-aligned staleness and minute support by @jlowin in #35
  • Add lifespan() context manager for provider lifecycle by @jlowin in #38
  • Remove unused materialization plugin system by @jlowin in #39
  • Refactor providers as Pydantic BaseModels by @jlowin in #41
  • Refactor LLM functions to provider pattern with caching by @jlowin in #44
  • Use >> icon for cached files instead of circle by @jlowin in #42
  • Refactor provider system with Addressable protocol by @jlowin in #47
  • Rename providers namespace to colin by @jlowin in #50
  • Refactor provider system with Resource/Ref architecture by @jlowin in #53
  • Redesign refresh policy as cache configuration by @jlowin in #54
  • Flatten target directory structure by @jlowin in #55
  • Add GitHub Actions workflows for tests and static analysis by @jlowin in #36
  • Support absolute target-path configuration by @jlowin in #60
  • Rename target/ to output/ by @jlowin in #78
  • Add interactive prompting for missing variables by @jlowin in #88
  • Add --no-interactive flag for CI environments by @jlowin in #89
  • Skip no-commit-to-branch hook in CI by @jlowin in #93
  • Warn when documents compiled with stale colin.toml by @jlowin in #96
  • Add --ephemeral flag to skip .colin/ writes by @jlowin in #98
  • Improve CLI output formatting and error messages by @jlowin in #99
  • Show model path in Compiling header, output path as tree root by @jlowin in #110
  • Show blueprint instructions after init by @jlowin in #112
  • Remove stray file by @jlowin in #113
  • Add .mintignore by @seanpwlms in #117
  • Register FileProvider by @seanpwlms in #118
  • Fix Notion page version to be deterministic by @jlowin in #133
  • Create publish.yml for pypi workflow by @jlowin in #129
  • Add Claude GitHub workflows by @jlowin in #138
  • Guard colin init against non-empty directories by @jlowin in #142
  • Improve blueprint init UX by @jlowin in #141
  • Rename PyPI package to colin-py and add release metadata by @jlowin in #145

Fixes 🐞

  • Fix github link by @jlowin in #23
  • Fix double .md extension in --dry-run output by @zzstoatzz in #31
  • Fix init_project creating directory before saving config by @jakekaplan in #28
  • Fix cache=always to respect source file changes by @jlowin in #94
  • Remove --no-interactive flag by @jlowin in #100
  • Track provider config changes for cache invalidation by @jlowin in #103
  • Fix event loop warning filter and example configs by @jlowin in #104
  • Remove dry-run feature by @jlowin in #105
  • Fix position-based IDs for LLM calls by @jlowin in #106

Docs 📚

  • Add comprehensive 'everything' example by @jlowin in #12
  • Add Mintlify documentation by @jlowin in #14
  • Add ADRs for tem...
Read more

v0.0.2: Quick Fix

23 Jan 20:09
9b68b18

Choose a tag to compare

Revamp quickstart and add Linear/Notion to provider docs (#147)

v0.0.1: Is this thing on?

23 Jan 16:40
35bdd14

Choose a tag to compare

Testing, testing...