Communitygithub.com

Ryzoner/agent_skills

Use quando o usuário pergunta como verificar o modo de acesso do Codex, continuar o diálogo anterior instantaneamente, usar `codex resume` ou recuperar o ID da sessão mais recente dos arquivos de sessão locais do Codex sem reler conversas antigas.

O que é agent_skills?

Esta skill fornece um conjunto de comandos e práticas recomendadas para gerenciar sessões do Codex CLI, com foco em verificar permissões de acesso, retomar diálogos anteriores e bifurcar sessões de forma eficiente. Ela documenta como usar `codex resume` e `codex fork` com UUIDs de sessão ou a flag `--last`, além de explicar a diferença entre os comandos e quando usar `--dangerously-bypass-approvals-and-sandbox` para modo de acesso total. A skill também mostra como localizar rapidamente a sessão mais recente no sistema de arquivos (`${CODEX_HOME:-$HOME/.codex}/sessions/YYYY/MM/DD/*.jsonl`) e extrair o UUID do nome do arquivo, sem precisar reler o conteúdo completo. Suportada em qualquer ambiente onde o Codex CLI esteja instalado, esta skill é essencial para desenvolvedores que desejam retomar o trabalho exatamente de onde pararam ou explorar abordagens alternativas sem perder o contexto anterior.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Ryzoner/agent_skills/tree/HEAD/.agents/skills/codex-cli-permissions-and-session-resume

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

codex-cli-permissões-e-retomada-de-sessão

Use esta skill quando:

  • o usuário pergunta se o Codex atualmente tem acesso total
  • o usuário menciona /permissions, FullAccess ou termos semelhantes de modo de acesso
  • o usuário deseja continuar um diálogo anterior do Codex imediatamente
  • o usuário pergunta como usar codex resume
  • o usuário pergunta como codex fork difere de codex resume
  • o usuário deseja o ID da sessão mais recente dos arquivos de sessão locais do Codex

Escopo

Este é um fluxo de trabalho global do Codex, não específico de um projeto. Ele pertence a ${CODEX_HOME:-$HOME/.codex}/skills/ porque os comandos e a estrutura de sessão são reutilizáveis entre repositórios.

Lembretes de modo de acesso

  • Na interface interativa do Codex, /permissions é a verificação rápida do modo de acesso atual.
  • Na ajuda da CLI, a flag explícita para acesso total é --dangerously-bypass-approvals-and-sandbox.
  • --full-auto não é a mesma coisa. Ainda usa workspace-write.
  • resume e fork aceitam os mesmos flags globais de execução que uma execução interativa normal.
  • Prefira flags documentadas de codex --help em vez de aliases não documentados.

Comandos rápidos de retomada

Prefira estes:

codex resume <SESSION_UUID>
codex resume --last
codex fork <SESSION_UUID>
codex fork --last
codex resume --dangerously-bypass-approvals-and-sandbox <SESSION_UUID>
codex resume --dangerously-bypass-approvals-and-sandbox --last

Importante:

  • codex resume aceita oficialmente um UUID de sessão ou nome de thread
  • codex fork aceita oficialmente um UUID de sessão e cria um novo ramo daquela sessão anterior
  • codex resume também aceita os mesmos flags globais de execução, como --dangerously-bypass-approvals-and-sandbox
  • prefira o UUID, não o nome do arquivo .jsonl
  • se o nome do arquivo for rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl, o comando de retomada preferido é:
codex resume 019d122d-9c09-7572-addf-ee59fab48e1b

Se você quiser que a sessão retomada permaneça em estilo de acesso total, use:

codex resume --dangerously-bypass-approvals-and-sandbox 019d122d-9c09-7572-addf-ee59fab48e1b

Se você quiser um novo ramo de pensamento em vez de continuar a mesma linha de raciocínio, use:

codex fork 019d122d-9c09-7572-addf-ee59fab48e1b
codex fork --last

Estrutura dos arquivos de sessão

As transcrições das sessões do Codex ficam em:

${CODEX_HOME:-$HOME/.codex}/sessions/YYYY/MM/DD/*.jsonl

Exemplo:

${CODEX_HOME:-$HOME/.codex}/sessions/2026/03/21/rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl

Maneira mais rápida de encontrar a sessão mais recente

Não desça manualmente ano -> mês -> dia, a menos que necessário. Prefira a ordenação por timestamp:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -1

Para listar várias sessões recentes:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -10

Como extrair o UUID rapidamente

Do caminho mais recente, pegue o UUID final antes de .jsonl.

Exemplo:

rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl

UUID:

019d122d-9c09-7572-addf-ee59fab48e1b

Depois retome com:

codex resume 019d122d-9c09-7572-addf-ee59fab48e1b

Regra prática

Quando o usuário quiser restaurar o contexto em um segundo:

  1. verifique /permissions se o modo de acesso for importante
  2. prefira codex resume --last para a sessão anterior mais recente
  3. se um arquivo de sessão específico for conhecido, reduza-o ao UUID e execute codex resume <UUID>
  4. use ${CODEX_HOME:-$HOME/.codex}/sessions/*/*/*/*.jsonl apenas para descobrir ou confirmar o UUID, não para reler a transcrição inteira, a menos que a retomada seja impossível

Quando ler o arquivo de sessão diretamente

Ler o próprio .jsonl é válido e útil quando:

  • você deseja o contexto anterior sem alternar a sessão interativa ativa ainda
  • você deseja resumir, pesquisar ou verificar o que aconteceu antes de retomar
  • você só conhece o caminho do sistema de arquivos e deseja recuperar o UUID da sessão
  • você precisa dos últimos turnos do usuário ou assistente imediatamente do disco

Regra preferida:

  • continuação mais rápida do mesmo diálogo -> codex resume <UUID> ou codex resume --last
  • ramo limpo do mesmo diálogo anterior para exploração alternativa -> codex fork <UUID> ou codex fork --last
  • mesma continuação, mas explicitamente em modo de acesso total -> codex resume --dangerously-bypass-approvals-and-sandbox <UUID> ou codex resume --dangerously-bypass-approvals-and-sandbox --last
  • inspeção mais rápida do contexto anterior a partir do disco -> abra o arquivo sessions/.../*.jsonl mais recente

Retomar vs bifurcar vs paralelismo

Use:

  • resume para continuar a mesma sessão e linha de raciocínio
  • fork para ramificar essa sessão em uma nova linha de trabalho

Não trate duas execuções simultâneas de resume da mesma sessão como um fluxo de trabalho limpo com múltiplos proprietários. Se você precisar de verdadeira exploração paralela, prefira:

  • fork para abordagens alternativas
  • subagentes do Codex para análise paralela limitada
  • processos separados do Codex em diferentes ramos ou áreas de trabalho para implementação pesada paralela

Fluxo de trabalho combinado prático

Para a conversa anterior mais recente:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
latest=$(ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -1)
printf '%s\n' "$latest"

Se você quiser inspecionar o arquivo primeiro:

tail -n 80 "$latest"

Se você quiser continuá-lo diretamente:

codex resume --last

Se você quiser continuá-lo diretamente em modo de acesso total:

codex resume --dangerously-bypass-approvals-and-sandbox --last

Se você precisar do UUID a partir do nome do arquivo:

basename "$latest" .jsonl | grep -oE '[0-9a-f]{8,}-[0-9a-f-]+$'

Habilidades Relacionadas