Tutorial 1: Seu primeiro projeto

O loop principal: criar um projeto → inicializar a sessão do agente → anexar → trabalhar → desanexar.

ccmux — novo projeto

1. Crie um projeto no TUI

Abra ccmux:

ccmux

Pressione 2 para ir para a tela Projetos e depois n para abrir o formulário de novo projeto.

Preencha:

• Nome — o nome do diretório do projeto (por exemplo, api-service)
• Anfitrião — em qual máquina executá-lo (o padrão é local)
• Agente — Claude, Codex, Antigravity, Cursor, pi ou Grok; usar ←/→ para alternar

Pressione Enter para criar o diretório e inicializar a sessão. ccmux volta para a tela inicial, onde a nova sessão aparece imediatamente.

Atalho CLI. Se preferir a linha de comando:

ccmux new api-service

Mesmo resultado — diretório criado em projects.root, sessão tmux iniciada com o agente padrão (ou aquele armazenado em <project>/.ccmux/agent).

2. Anexar à sessão

Na tela inicial, navegue até a sessão com j / k e pressione Enter para anexar.

Agora você está dentro da sessão tmux executando seu agente. Quando terminar:

• Ctrl-b d — desanexar; ccmux TUI retoma automaticamente
• A sessão continua sendo executada em segundo plano

3. Verifique o status sem anexar

Você pode ler o estado da sessão no painel sem interromper o agente. O needs_input O indicador (vermelho) é aquele a ser observado – significa que o agente está aguardando sua resposta.

Para listar sessões do shell:

ccmux list

4. Notas do projeto

Pressione 4 no TUI para abrir o Notas guia para este projeto. Todo .md arquivo na árvore do projeto aparece em uma lista agrupada por pastas; selecionar um o renderiza com Glamour.

Pressione / para pesquisar todas as notas com ripgrep.

A desconexão deixa a sessão em execução em tmux enquanto o host permanece ativo. A proteção de suspensão padrão macOS funciona com alimentação CA e não substitui a suspensão com tampa fechada. Revise o configurações de suspensão antes de deixar um laptop sem supervisão.

Detectou um erro ou algo desatualizado? Edite esta página em GitHub.