sitrep

Aggregate Git, GitHub, and Linear data into a persistent STATUS.md file.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/mihai-chiorean/inc --skill sitrep-mihai-chiorean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sitrep
Source: https://github.com/mihai-chiorean/inc/tree/main/skills/sitrep
Command: npx skills add https://github.com/mihai-chiorean/inc --skill sitrep-mihai-chiorean

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, linear-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill eliminates the cognitive overhead of manually gathering project state by providing a unified, persistent landing page that tracks your current progress, blockers, and next steps across Git, GitHub, and Linear.

Core Features & Use Cases

  • Operational Dashboard: Surfaces a single-page view of your active branch, PR status, and pending tasks.
  • Context Synchronization: Automatically reconciles your local Git state with your project's STATUS.md contract.
  • Use Case: Start your workday by running this skill to immediately identify which PRs require your review, which Linear issues are assigned to you, and what your primary objective is for the current session.

Quick Start

Run the sitrep command to generate a comprehensive status report for your current project directory.

Frequently Asked Questions about sitrep

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

FAQPage Schema
How do I synchronize local git state with GitHub and Linear assigned issues?

You can synchronize project state by aggregating data from Git, GitHub, and Linear into a persistent STATUS.md file, which reconciles active branches, open pull requests, and assigned issues.

What is the best way to get an instant project status report for my current directory?

Generating an instant project status report is done by running the sitrep command, which aggregates your active branch, pending PRs, and Linear tasks into a single operational dashboard view.

Do I need local authentication for GitHub and Linear CLI tools to track project status?

Yes, you need local authentication for GitHub and Linear CLI tools to perform real-time status verification and state updates when reconciling your project's operational context.

Can I use this workflow to identify which pull requests require review and what my next task is?

Yes, the workflow surfaces a single-page view to immediately identify which PRs require your review, which Linear issues are assigned to you, and your primary objective for the session.

How does context synchronization work when tracking active branches and pending tasks?

Context synchronization works by automatically reconciling your local Git state with your project's STATUS.md contract, ensuring your tracked progress, blockers, and next steps remain unified.

Are there limitations when using this approach to manage operational context across multiple repositories?

The approach is limited to synchronizing data for your current project directory and does not explicitly support aggregating operational context across multiple separate repositories simultaneously.