Configuration
Quick Setup
Use a preset to get started fast:
# CorvidLabs preset - sets author, org, license, template repo
fledge config init --preset corvidlabs
# Default config
fledge config init
Config File
Lives at:
~/.config/fledge/config.toml
Sections
[defaults]
Default values for new projects:
[defaults]
author = "Your Name"
github_org = "YourOrg"
license = "MIT"
| Key | What it does | Fallback |
|---|---|---|
author | Default author name | git config user.name |
github_org | Default GitHub org | Prompted |
license | Default license | MIT |
[templates]
Where to find templates:
[templates]
paths = ["~/my-templates", "~/work/templates"]
repos = ["CorvidLabs/fledge-templates", "myorg/templates"]
| Key | What it does |
|---|---|
paths | Local directories with templates |
repos | GitHub repos to pull templates from (owner/repo) |
[github]
[github]
token = "ghp_..."
Token priority:
FLEDGE_GITHUB_TOKENenv varGITHUB_TOKENenv var- Config file
gh auth token(GitHub CLI fallback)
Required token scopes:
| Feature | Scopes needed |
|---|---|
| Issues, PRs, CI checks | repo (or public_repo for public repos only) |
| Create PRs, push branches | repo |
| Search templates/plugins | public_repo |
| Publish templates | repo, delete_repo (if republishing) |
A classic token with repo covers everything. For fine-grained tokens, grant Read/Write on Contents, Pull Requests, and Issues for each repo you work with.
Full Example
[defaults]
author = "Leif"
github_org = "CorvidLabs"
license = "MIT"
[templates]
paths = ["~/.fledge/templates", "~/projects/templates"]
repos = ["CorvidLabs/fledge-templates", "my-org/my-templates"]
[github]
token = "ghp_1234567890abcdefghijklmnopqrstuvwxyz"
Environment Variables
| Variable | What it does |
|---|---|
FLEDGE_GITHUB_TOKEN | GitHub token (highest priority) |
GITHUB_TOKEN | GitHub token (fallback after FLEDGE_GITHUB_TOKEN) |
If neither env var nor config is set, fledge falls back to gh auth token (GitHub CLI) automatically.
Project Configuration (fledge.toml)
Per-project settings live in fledge.toml in your project root. This file defines tasks, lanes, and project metadata. It’s created by fledge run --init or fledge templates init.
For task and lane configuration, see:
- Lanes & Pipelines — defining lanes, step types, parallel groups, importing community lanes
- Plugins — extending fledge with community plugins
Priority Order
When creating a project, values come from (highest to lowest):
- Command-line arguments
- Config file
- Git config (author only)
- Built-in defaults