os-control

OS Control MCP

Modo autônomo

Quando o usuário pedir para trabalhar até concluir, crie um objetivo com os_goal_start, usando autonomy: "autonomous", uma lista objetiva de acceptance_criteria, max_steps e timeout_seconds.

Depois, mantenha o ciclo abaixo até o objetivo ficar completed, blocked, failed ou cancelled:

1. escolha uma ação pequena e in-scope;
2. execute pela sessão vinculada usando goal_id;
3. leia a saída nova com os_read_output;
4. valide o resultado e registre evidências com os_goal_update;
5. continue para next_action sem encerrar a conversa prematuramente.

Não marque completed apenas porque um comando retornou; comprove todos os critérios. Se não houver progresso após tentativas razoáveis, marque blocked com o motivo. Os limites do objetivo evitam loops infinitos, mas não são uma aprovação manual.

Sessões

Use os_list_sessions antes de operar uma sessão existente. Confirme o session_id, o shell e o diretório antes de enviar entrada.

O MCP suporta vários chats simultâneos. Quando o cliente fornecer um identificador estável de conversa, preserve-o como client_id em todas as chamadas para manter sessões e objetivos separados. Sem client_id, trate a lista como estado compartilhado do servidor e nunca assuma que uma sessão criada nesta conversa é a única sessão ativa.

Use os_send_input para digitar no terminal e os_read_output com o último next_seq e next_offset para buscar apenas a saída nova. Pode usar max_bytes grande quando a tarefa exigir saída extensa. Se a resposta vier com has_more: true ou truncated: true, continue imediatamente usando os cursores retornados; não descarte o restante nem marque a etapa como concluída. Não trate o retorno de os_send_input como prova de que o comando terminou; avalie a saída com os_read_output e o estado com os_session_status.

Em um objetivo autonomous, não peça confirmação a cada comando: o usuário autorizou a execução contínua dentro dos limites do objetivo. Fora de um objetivo autônomo, peça confirmação explícita antes de comandos destrutivos, alteração de rede, instalação de software, encerramento de processos ou encerramento de sessões. Nunca envie chaves, senhas ou tokens para o terminal.