mica-code

Mica Code (MICA — Minimal, Intelligent, Cache-first Agent) é um agente de codificação de IA leve e nativo de terminal, cujo objetivo central de design é reutilizar contexto e manter uma alta taxa de acerto de cache. Principais características: - Prefixo estável, cache em primeiro lugar: as sessões são por padrão append-only, tentando bloquear o prefixo de system/history, mantendo alta taxa de acerto de cache mesmo em conversas longas. - Nativo de terminal: TUI baseado em Ink, priorizando teclado, com exibição centralizada de múltiplos agentes, tarefas em segundo plano e status. - Referência a arquivos: digite @ para pesquisar arquivos no diretório de trabalho atual, use as setas para selecionar e Enter ou Tab para inserir. - Role como fluxo de trabalho: /role substitui completamente o system prompt, permitindo configurar diferentes personalidades para codificação, revisão e planejamento. - Ferramentas modulares: inclui ferramentas integradas de arquivo, busca, shell, web e skills, com suporte a integração de scripts pessoais e serviços de equipe via MCP. - Reversível, compactável e agendável: /rewind retorna a nós históricos de conversa e pode restaurar arquivos em pontos de verificação; /compact substitui por padrão apenas resultados de ferramentas por placeholders, /compact llm usa resumos do modelo; /loop executa tarefas em intervalos fixos. Instalação e configuração: Pode ser instalado via script install.sh do GitHub Release e executado com mica. A primeira execução cria ~/.mica/config.json, e /config abre a página de configuração. A configuração suporta múltiplos provedores, com protocolo opcional openai_chat_completions ou openai_responses; é possível configurar get_model_url para obter dinamicamente a lista de modelos, ou configurar diretamente um array estático de models; também suporta configurar mcpServers. Interfaces de linha de comando: - mica exec: execução headless única, alinhada ao protocolo do OpenAI Codex, com suporte a --json para saída ThreadEvent JSONL, --thinking, --no-save, --session, --dir, --mcp-init-timeout-ms, entre outros. - mica compact: compacta o contexto de uma sessão existente, com suporte a --force, --prune-only, --tool-results-only, e saída JSON com estimativas de tokens e proporção de compactação. - mica commit: reutiliza a lógica de análise determinística do /commit interativo, envia apenas uma solicitação ao modelo para gerar a mensagem de commit, e executa git add/commit/push com saída JSON. - mica app-server: processo de sessão persistente, expondo um subconjunto do protocolo App Server v2 do Codex, com suporte a injeção iterativa de turn/steer. Este projeto é adequado para desenvolvedores que desejam usar um assistente de codificação de IA no terminal, com foco em eficiência de cache de contexto e chamadas scriptáveis.