# flicker

> Agent-first terminal text animations — library, MCP server, and CLI.

flicker renders typewriter, spinner, and progress effects in a terminal without corrupting MCP stdio, burning context with ANSI escape noise, or opening a Terminal-DiLLMa surface. The MCP server is the primary product; the CLI is a human convenience layer on the same engine.

## Install

- [npm package](https://www.npmjs.com/package/@capitalthought/flicker): npm install -g @capitalthought/flicker
- [MCP server install](https://flicker.sh/#mcp): claude mcp add flicker npx @capitalthought/flicker mcp

## Docs

- [AGENTS.md](https://flicker.sh/AGENTS.md): agent-facing contract — tool sequencing, hard contracts, what flicker won't do
- [GitHub README](https://github.com/capitalthought/flicker#readme): human-facing intro and examples

## Optional

- [Design doc](https://github.com/capitalthought/flicker/blob/main/docs/plans/2026-05-17-flicker-design.md): v0.1 architecture
- [Research brief](https://github.com/capitalthought/flicker/blob/main/docs/research/2026-05-16-terminal-animation-research.md): terminal-animation landscape