README.md

# Unix Copilot v0.2.0

Skills-only OpenAI plugin for shell commands and safe Unix/Linux/macOS workflows. Existing public name and internal package identifier `unix-copilot` are preserved.

## Use

Start with `skills/get-started/SKILL.md`. The router selects one of 18 focused task skills. References support shell correctness, risk boundaries, Linux/macOS differences, and developer tooling. The original technical skill and its six references are retained byte-for-byte under `legacy/original/` for audit, not activated as a competing router.

This plugin contains **no MCP server, no access token and no standalone shell execution**. Host tools may execute only when genuinely available and authorized. Running this plugin alone does not inspect a machine or change files. Shell commands are proposed until evidence establishes execution.

## QA

Run `python3 scripts/validate_package.py` and `python3 -m unittest discover -s tests -v`. Two safe runnable examples are included: `examples/select_csv_columns.py` for quoted/multiline CSV and `examples/safe_file_inventory.py` for filename-safe JSON inventory. They do not modify input files. Offline static checks don't validate the plugin's behavior inside an installed ChatGPT/Codex host; benchmark cases are specifications awaiting real runs.

## Public submission

Developer: Tekris Labs; 3 prompts; four public Tekris Labs URLs; preserved original icons; release 0.2.0. See `SUBMISSION.md`.