Metis v2.1.0

See the assets to download this version and install.

v2.0.5

Changes

• Viewer: remove proactive open on create — documents now only auto-open in the external viewer on edits, not creates
• Viewer: add background mode — new background = true option in [viewer] config opens documents without stealing window focus (open -g on macOS)
• Clippy fixes and rustfmt across workspace

Metis v2.0.4

See the assets to download this version and install.

Metis v2.0.3

See the assets to download this version and install.

Metis v2.0.2

See the assets to download this version and install.

Metis v2.0.1

See the assets to download this version and install.

Metis v2.0.0

Metis 2.0.0

What changed and why

Strategy is gone. Specification is here.

Metis inherited the Strategy document type from Flight Levels methodology as a coordination layer between Vision and Initiative. In theory, strategies coordinate work across teams and repositories. In practice — across 20+ projects, 6+ month cycles, dozens of initiatives, and hundreds of tasks — strategies were never meaningfully used. When created, they became static props that never changed. They added a hierarchy level without adding information or decision points.

This happened because Metis is operationally coupled to the repository, and that's a strength. Cross-team coordination happens in other tools. Metis is where the work gets done.

So we removed Strategy entirely. The S short code prefix, the hierarchy slot, and the cognitive overhead are all freed up.

In its place: Specification — a document type that actually earns its spot in the hierarchy. Specifications are living system-level design documents that capture what Vision and Initiative couldn't:

• PRDs with numbered requirements (REQ-x.x.x, NFR-x.x.x)
• System context — actors, external systems, boundaries
• Architecture framing — decision areas that spawn ADRs
• Constraints and changelogs that evolve as the system does

Unlike Vision (static once published), Specifications remain editable after publishing. Requirements get added, mutated, or dropped as the system evolves. Unlike Initiative (time-bounded execution), Specifications are living documents that multiple initiatives execute against over months.

Specifications attach to Visions or Initiatives as supporting design documents — they don't change the Vision → Initiative → Task execution hierarchy.

Other changes

• Parent document navigation — Documents now show their parent and child documents in the viewer, with clickable navigation between them. Parent relationships are persisted in the database instead of parsed on the fly.
• GUI improvements — Specification table view with clickable parent links, reordered board tabs to follow the natural work generation flow (Vision → Initiative → Task → ADR → Specification).

Breaking changes

This is a major version bump. If you have existing Metis projects:

• Strategy documents are no longer recognized. No known deployments have real strategy documents in use, but if you do, they'll be ignored.
• create strategy CLI command removed
• "strategy" document type no longer valid in MCP tools
• strategies_enabled config key removed
• "full" preset removed — streamlined (Vision → Initiative → Task) is the default and recommended preset
• Filesystem layout — initiatives no longer nest under strategies/. Delete your .metis/metis.db to rebuild after upgrading.

Install

curl -fsSL https://raw.githubusercontent.com/colliery-io/metis/main/scripts/install.sh | bash

Or download directly from the assets below.

Metis v1.2.0

See the assets to download this version and install.

Metis v1.0.11

See the assets to download this version and install.

v1.0.10

Changes

Refactor: Consolidated Phase Transition Logic

• Single source of truth for phase transitions in DocumentType
• Added methods: valid_transitions_from(), can_transition(), next_phase(), phase_sequence()
• All document types and services now delegate to DocumentType

Documentation Fixes

• Fixed phase transitions to be forward-only (matching implementation)
• Added Strategy document type to instructions
• Fixed prefix length documentation (2-8 uppercase chars)
• Added critical risk level option

Plugin Restructure

• Reorganized plugin from skill/ to plugins/metis/
• Updated marketplace.json

Dependencies

• Updated @tauri-apps/plugin-dialog to v2.5.0

Full Changelog: v1.0.9...v1.0.10