$ initiat guides
Local Project Configuration
Set up project-specific configuration using .initiat/config.yml for automatic project context
Back to Docs

Steps

#1 Navigate to Project Directory

Go to your project directory

      cd /path/to/your/project
      
    

Local configuration files are read from the current directory. Must be in a git repository.

#2 Initialize Project Configuration

Create .initiat/config.yml with project context

      initiat project init acme-corp/production
      
    

This creates .initiat/config.yml with your project's org and project settings. The command will automatically create this file if you're in a git repository.

#3 Verify Local Configuration

Check the contents of your configuration file

      cat .initiat/config.yml
      
    

The file should contain org and project settings that define the project context

#4 Test Local Configuration

Test that local configuration is working

      initiat secret list
      
    

Commands should now use the local project context automatically without needing to specify --project-path

#5 Override with Flags (Optional)

Override local config with command flags when needed

      initiat secret list --project-path other-org/other-project
      
    

Command-line flags always take precedence over local configuration

Success criteria

  • .initiat/config.yml file is created in project directory

  • Commands use local project context automatically

  • Can override local config with command flags when needed

Next steps

  • Share .initiat/config.yml with team members (commit to git)

  • Set up local config for multiple projects

  • Use project aliases for even faster workflow

© 2025 Initiat Technologies. All rights reserved.