Koine

Koine

CLI que injeta contexto multi-camada (usuário, agente, referências, contexto da pasta) em harnesses de IA terminal — Claude Code, Antigravity (`agy`), GitHub Copilot CLI, OpenCode, Codex CLI.

[](LICENSE) [](pyproject.toml)

Por que existe

Agentes de IA terminal abrem cada sessão zeradas. O usuário precisa repetir, a cada turno, quem é, em que projeto trabalha, qual padrão da casa, qual contexto da pasta. Repetir contexto consome tempo, polui prompts e degrada qualidade da resposta.

Koine resolve isso separando o que normalmente vem embaralhado em "memória de agente":

1. Harness — koine carrega o contexto e o entrega ao cliente IA pelo canal que ele oferece, sem escrever nada na sua pasta de trabalho
2. Habilidades — skills kn-* que o agente invoca durante a sessão
3. Base de conhecimento — bundle OKF com perfis, escopos, domínios e referências; propriedade do usuário
4. Sistema de arquivos — recomendado, não obrigatório

Cada camada evolui em ritmo próprio. O agente IA passa a "já saber" quem você é, no que está trabalhando e onde está, sem precisar contar de novo a cada turno.

Pré-requisitos

Para Koine fazer sentido, você precisa de:

• Python 3.12+ — o Koine é distribuído como aplicação Python (koine.pyz). macOS: brew install python; Windows: instalador oficial em https://www.python.org/downloads/ (ou o Python da sua TI); Linux: gerenciador do sistema (apt install python3 etc.).
• Um cliente IA terminal suportado — Claude Code, Antigravity, GitHub Copilot CLI, OpenCode ou Codex CLI. Tabela abaixo na seção Clientes IA suportados.
• Node.js 18+ (recomendado 22+) — necessário para instalar Claude Code e Copilot CLI via npm. Download: https://nodejs.org/.
• Homebrew (opcional em macOS) — ge