CLI

O MuxCode CLI é um terminal interativo (TUI) que conecta você aos modelos de IA da MuxCode diretamente no terminal. Single binary Rust, sem dependências externas.

Rápido: Não precisa de Node, Bun, Python ou runtime nenhum. Um binário só.

Instalação

# Windows (PowerShell)
irm https://muxcode.dnsdojo.com/install.ps1 | iex

# Linux / macOS
curl -fsSL https://muxcode.dnsdojo.com/install.sh | sh

Uso

muxcode                    # Inicia a TUI interativa
muxcode --help             # Mostra ajuda
muxcode --version          # Versão atual
muxcode --update           # Auto-update para última versão
muxcode -p "prompt"        # Modo headless (executa e sai)
muxcode -m modelo -p "x"   # Headless com modelo específico

Slash Commands

Digite / no input para usar comandos:

Comando	O que faz
`/q`	Sai do programa
`/new`	Limpa o histórico e começa sessão nova
`/help`	Lista todos os comandos disponíveis
`/models`	Mostra modelos disponíveis e abre o seletor
`/usage`	Mostra tokens consumidos na sessão
`/config`	Mostra configuração atual
`/config chave=valor`	Altera config (ex: /config default_model=reiko-3.2)
`/update`	Baixa e instala a versão mais recente
`/restart`	Reinicia o binário (útil pós-update)
`/save`	Força salvamento da sessão atual
`/mode plan`	Alterna para modo planejamento
`/mode code`	Alterna para modo código
`/mode ask`	Alterna para modo perguntas
`/fork`	Bifurca a sessão atual (novo ID, mesmo histórico)
`/cost`	Mostra custo estimado da sessão
`/verbose`	Alterna exibição raw JSON das tool calls
`/vim`	Alterna modo vim (i=inserir, Esc=normal, j/k=histórico)
`/git`	Mostra branch git atual

Atalhos de Teclado

Tecla	Ação
`Enter`	Envia a mensagem
`↑ ↓`	Navega pelo histórico de comandos
`Tab`	Cicla entre modelos disponíveis
`Ctrl+P`	Abre seletor de modelos
`Ctrl+C`	Sai do programa
`Esc`	Fecha seletor de modelos

Modos

O CLI suporta 3 modos de interação via /mode:

code — Foco em escrever e editar código (default)
plan — Planejamento e arquitetura antes de implementar
ask — Responder perguntas sem ferramentas

Sessões

O histórico de cada conversa é salvo automaticamente em ~/.local/share/muxcode/sessions/ (Linux) ou %LOCALAPPDATA%/MuxCode/sessions/ (Windows).

Ao iniciar o CLI novamente, a última sessão é carregada automaticamente.

Configuração

Arquivo de config em ~/.config/muxcode/config.json:

{
  "default_model": "reiko-3.2",
  "api_key": "",
  "portal_url": "https://muxcode.dnsdojo.com/api/v1"
}

Você pode alterar via /config chave=valor ou editando o arquivo diretamente.

Auto-Update

O CLI pode atualizar a si mesmo:

muxcode --update          # Via terminal (antes de entrar na TUI)
/update                   # Dentro da TUI

O binário é baixado do canal beta e substituído automaticamente. Use /restart após o update para recarregar.

Variáveis de Ambiente

Variável	Descrição	Default
`MUXCODE_PORTAL_URL`	URL base da API	https://muxcode.dnsdojo.com/api/v1
`MUXCODE_API_KEY`	Chave de autenticação da conta	`mux-...`

Ferramentas Disponíveis

O modelo pode usar estas ferramentas automaticamente:

Ferramenta	O que faz
`bash`	Executa comandos no terminal
`read`	Lê conteúdo de arquivos
`write`	Cria ou sobrescreve arquivos
`edit`	Faz substituições exatas em arquivos
`glob`	Busca arquivos por padrão
`grep`	Busca conteúdo com regex
`webfetch`	Baixa conteúdo de URLs
`websearch`	Pesquisa informações atuais na web