cops-cli

Complyance CLI tool to automate Linear tasks, GitHub operations, and documentation workflows.

Features

• Create Linear tasks and subtasks from Markdown folders
• Scaffold documentation folders for task planning
• Apply GitHub branch diffs to your working directory
• Modular: add more providers and automations easily

Installation

npm install -g cops-cli

Configuration

Set your Linear API key (only needed for Linear commands):

cops-cli config

This will prompt for your API key and save it securely in ~/.cops-cli/config.json.

Usage

Create Linear Tasks from Markdown

cops-cli create

• Select your Markdown folder (with parent.md and subtasks)
• Choose team, project, labels, assignee, and priority
• Issues and subtasks are created in Linear, and .md files are updated with issue IDs

Scaffold Documentation Folders

cops-cli doc

• Prompts for parent folder and subtask names
• Creates skeleton Markdown files for you to fill in

Apply GitHub Branch Diff

cops-cli github:apply-diff <branch>

• Applies the diff from the specified branch to your current working directory (like a smart patch)

Example Workflow

# Set your Linear API key (first time only)
cops-cli config

# Scaffold a new doc folder
cops-cli doc

# Fill in parent.md and subtask .md files

# Create issues in Linear
cops-cli create

# Apply a GitHub branch diff
cops-cli github:apply-diff feature/my-feature

Extending

• Add more providers (Jira, Asana, etc.) in src/providers/
• Add more commands for GitHub or other tools as needed

© Complyance. MIT License.