Skip to content

CLAUDE.md

Latest commit

 

History

History
27 lines (20 loc) · 1.14 KB

CLAUDE.md

File metadata and controls

27 lines (20 loc) · 1.14 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Development Commands

  • cargo run -- <args> - Run CLI during development
  • cargo test - Run tests
  • cargo lint-fix - Fix linting issues automatically (run after making changes)
  • cargo fmt - Format code (run after making changes)
  • cargo clippy - Check for linting issues
  • nix-shell - Enter dev environment with dependencies

Architecture

  • Commands: src/commands/ - CLI commands using clap derives, each with exec() function
  • Controllers: src/controllers/ - Business logic for Railway entities (project, service, deployment)
  • GraphQL: src/gql/ - Generated type-safe queries/mutations for Railway API
  • Config: src/config.rs - Authentication and project settings
  • Workspace: src/workspace.rs - Multi-project context handling

Command System

Commands use a macro system in main.rs. The commands! macro generates routing for modules in src/commands/.

Authentication

  • Project tokens via RAILWAY_TOKEN environment variable
  • User tokens via OAuth flow stored in config directory