unicli-claude-code

# Uni-CLI × Claude Code — Reliable Invocation > **TL;DR** — If the payload contains ANY of: quotes, emoji, newlines, JSON, > non-ASCII, or is longer than ~60 chars, PIPE IT. Never inline. ## Why this skill exists Transformers live in TC0. Matching balanced `"` and `'` pairs with arbitrary nesting is a mod-2 state-tracking problem that TC0 cannot solve in constant decode depth. Empirically, top LLMs land <43% on 0→1 CLI generation (CLI-Tool-Bench arXiv:2604.06742) and 62% of agent-tool bugs cluster at the tool-invocation / execution stages (arXiv:2603.20847). Uni-CLI gives you THREE invocation channels. One of them (shell-args) inherits the TC0 bottleneck. The other two do not. ## The decision rule | If the payload has … | Use channel | | ---------------------------------------- | --------------- | | Only ASCII, no quotes, <60 chars | `shell` OK | | Any quote or backslash | **stdin-JSON** | | Emoji / CJK / non-ASCII | **stdin-JSON** | | Newlines or inline JSON | **stdin-JSON** | | Being reused across multiple invocations | **--args-file** | When unsure → stdin-JSON. It never makes things worse. ## The three channels ### 1 — stdin-JSON (preferred for complex payloads) ```bash echo '{"query": "she said \"hi\" 🎉", "limit": 10}' | unicli twitter search ``` - Uni-CLI auto-detects non-TTY stdin whose body starts with `{` - Precedence: stdin-JSON > `--args-file` > shell flags > def...