Railway Projects

Gerenciamento de Projetos do Railway

Listar, alternar e configurar projetos do Railway.

Quando Usar

• Usuário pergunta "mostre todos os meus projetos" ou "que projetos eu tenho"
• Usuário pergunta sobre projetos em diferentes workspaces
• Usuário pergunta "que workspaces eu tenho"
• Usuário quer alternar para um projeto diferente
• Usuário quer renomear um projeto
• Usuário quer ativar/desativar deploys de PR
• Usuário quer tornar um projeto público ou privado
• Usuário pergunta sobre configurações do projeto

Listar Projetos

A saída de railway list --json pode ser muito grande. Execute em um subagent e retorne apenas campos essenciais:

• Projeto: id, name
• Workspace: id, name
• Services: name (opcional, se o usuário precisar de contexto de serviço)

railway list --json

Extraia e retorne um resumo simplificado, não o JSON completo.

Listar Workspaces

railway whoami --json

Retorna informações do usuário incluindo todos os workspaces aos quais o usuário pertence.

Alternar Projeto

Vincule um projeto diferente ao diretório atual:

railway link -p <project-id-or-name>

Ou interativamente:

railway link

Após alternar, use a skill railway-status para ver os detalhes do projeto.

Atualizar Projeto

Modifique as configurações do projeto via GraphQL API.

Obter ID do Projeto

railway status --json

Extraia project.id da resposta.

Mutation de Atualização

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation updateProject($id: String!, $input: ProjectUpdateInput!) {
    projectUpdate(id: $id, input: $input) { name prDeploys isPublic botPrEnvironments }
  }' \
  '{"id": "PROJECT_ID", "input": {"name": "new-name"}}'
SCRIPT

Campos de ProjectUpdateInput

Exemplos

Renomear projeto:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'

Ativar deploys de PR:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'

Tornar projeto público:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'

Múltiplos campos:

${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'

Composição

• Visualizar detalhes do projeto: Use a skill railway-status
• Criar novo projeto: Use a skill railway-new
• Gerenciar ambientes: Use a skill railway-environment

Tratamento de Erros

Não Autenticado

Not authenticated. Run `railway login` first.

Nenhum Projeto

No projects found. Create one with `railway init`.

Permissão Negada

You don't have permission to modify this project. Check your Railway role.

Projeto Não Encontrado

Project "foo" not found. Run `railway list` to see available projects.