ck

Manages per-project session state and generates context briefings via CLI.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/riftzen-bit/gemini-setup --skill ck-riftzen-bit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ck
Source: https://github.com/riftzen-bit/gemini-setup/tree/main/skills/ck
Command: npx skills add https://github.com/riftzen-bit/gemini-setup --skill ck-riftzen-bit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides persistent, per-repository memory so developers can quickly resume work with project context, goals, decisions, and recent git activity without re-explaining state each session.

Core Features & Use Cases

  • Session persistence: Save one-sentence summaries, left-off points, ordered next steps, decisions, and blockers into a versioned v2 context.json and a regenerated human-readable CONTEXT.md.
  • SessionStart briefing: Auto-injects a compact ~100-token briefing at session start that highlights goal, left-off, recent git activity, and unsaved-session warnings.
  • CLI operations: Deterministic Node.js scripts implement init, save, resume, info, list, forget, and migrate flows, including safe v1→v2 migration and native-memory markdown entries for indexing.
  • Use case: Register a repository, capture a session after edits, and later resume with a briefing that shows what was left off, next steps, and any git changes since the last save.

Quick Start

Register the current repository with /ck:init, confirm or edit the detected fields, and then use /ck:save after a session to persist the state.

Frequently Asked Questions about ck

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist and reload project context between git coding sessions?

To persist and reload project context between git coding sessions, register your repository with an init command and save session state. This stores summaries, next steps, and decisions into a versioned context.json file and regenerates a human-readable CONTEXT.md file for future reference.

What is per-project session management for local repository workflows?

Per-project session management is the process of saving one-sentence summaries, left-off points, and blockers into a versioned context.json. It automatically injects a compact briefing at session start, highlighting goals, recent git activity, and unsaved-session warnings without re-explaining state.

Do I need Node.js to run CLI commands for saving session state?

Yes, you need Node.js to execute the deterministic scripts that handle saving session state. The CLI commands run from your skills directory and require Node.js and filesystem access to update the v2 context.json and write native-memory markdown entries.

How do I migrate v1 context files to v2 context.json?

To migrate v1 context files to v2 context.json, run the dedicated migrate flow via CLI commands. This safe v1-to-v2 migration updates your session persistence format while preserving existing project memory and generated context documentation.

What's the best way to capture decisions and blockers in a local repository?

The best way to capture decisions and blockers in a local repository is using a session save command. This writes your ordered next steps and blockers into a versioned context.json and generates a human-readable CONTEXT.md, allowing you to resume work with a briefing later.

Can I list multiple registered repositories and check their saved git history?

Yes, you can list multiple registered repositories and check their saved git history. A portfolio list command displays registered projects, while the resume briefing reads recent git history to highlight unsaved-session warnings and changes since your last save.