Configuration

ProGit is configured through a KDL file at .project/config.kdl in your project root. KDL is a document language — think TOML but more readable for nested data.

File location

my-project/
├── .project/
│   ├── config.kdl      ← main config (commit this)
│   └── issues/
└── .progit/            ← local cache (gitignore this)

Minimal config

ProGit works without any config file — everything has sensible defaults. The only reason you need config.kdl is for forge sync.

sync {
    provider "gitlab"
    url "https://gitlab.com"
    owner "my-org"
    repo "my-project"
}

Theme

theme "dark"     // "dark" | "light"

Change from inside the TUI: press : → type theme light → Enter.

Sync configuration

GitLab

sync {
    provider "gitlab"
    url "https://gitlab.com"
    owner "my-org"
    repo "my-project"
}

Forgejo / Gitea

sync {
    provider "forgejo"
    url "https://git.example.com"
    owner "my-org"
    repo "my-project"
}

Self-hosted GitLab

sync {
    provider "gitlab"
    url "https://gitlab.mycompany.com"
    owner "team"
    repo "backend"
}

Tokens are not stored in config — use environment variables:

export GITLAB_TOKEN="glpat-xxxx"
export FORGEJO_TOKEN="your-token"
export PROGIT_TOKEN="fallback-token"   # tried first, works for any provider

Multi-repo setup

Manage issues across multiple repos from one ProGit instance:

repo "frontend" {
    path "../frontend"
    sync {
        provider "gitlab"
        url "https://gitlab.com"
        owner "my-org"
        repo "frontend"
    }
}

repo "backend" {
    path "../backend"
    sync {
        provider "gitlab"
        url "https://gitlab.com"
        owner "my-org"
        repo "backend"
    }
}

Plugin configuration

plugins {
    registry-url "https://git.sovereign-society.org/ProGit/progit-plugins"
}

Styles

Override built-in component colours:

style "issue-title" {
    fg "cyan"
    modifiers "bold"
}

style "status-done" {
    fg "green"
    modifiers "dim"
}

style "kanban-header" {
    fg "yellow"
    modifiers "bold" "underlined"
}

Supported modifiers: bold, italic, dim, underlined, crossed-out.

What ProGit ignores

ProGit intentionally does not store in config:

Auth tokens (use env vars)
User identity (read from git config)
Editor preferences (reads $EDITOR)

Full example

theme "dark"

sync {
    provider "forgejo"
    url "https://git.sovereign-society.org"
    owner "ProGit"
    repo "progit"
}

plugins {
    registry-url "https://git.sovereign-society.org/ProGit/progit-plugins"
}

style "kanban-header" {
    fg "cyan"
    modifiers "bold"
}