1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
# version = 1 # optional; 1 is the only schema version and the default
# protocol selects https vs ssh for host-aliased sources; default https.
# Uncomment to flip the global default (still overridable per source):
# protocol = "ssh"
# A bare `phora add <url>` (no --to) ensures [targets.default] (path ".", flat)
# and binds the source into it. Set auto_target = false to make bare add
# declare-only (it then deploys nowhere until bound or routed with --to).
[]
= true
# Pin where phora keeps its git-mirror cache and per-project state, overriding the
# XDG env vars and platform defaults. Both keys are optional and independent. A
# relative value resolves under the project root; an absolute value is used as-is.
# The configured path IS the root (no `phora` leaf is appended).
# [paths]
# cache = ".phora/cache" # git mirrors live under <root>/git/
# state = ".phora/state" # registry/locks/journal live under <root>/projects/
# github, gitlab, codeberg, sr.ht, bitbucket ship built in (both https + ssh),
# so a `[hosts]` block is only needed to add a forge or override auth/remote.
[]
= { = "token", = "GITHUB_TOKEN" }
# A custom forge: `remote` is a string (https only) or a { https, ssh } table.
# Templates fill {path} verbatim; {owner} is the first segment, {repo} the rest.
[]
= { = "https://git.company.com/{path}.git", = "git@git.company.com:{path}.git" }
= { = "ssh", = "~/.ssh/id_ed25519" }
# A source is a git repo, and it OWNS its selection: `root` re-anchors the slice,
# `include`/`exclude` compose `include − exclude` (exclude wins; no `!` negation).
# Pin with exactly one of branch / tag / rev (defaults to branch `main`).
# Pick exactly one source kind: forge (host + repo), local (path), literal (git),
# or url. A bare `repo = "owner/repo"` defaults to github; a bare `path` is LOCAL.
# Forge source: resolves via the host's `remote` template at sync time. `root`
# re-anchors the offer at `modules`, so artifacts are named relative to it.
[]
= "github" # omit to default to github when `repo` is set
= "me/dotfiles" # deprecated alias: `path` (forge owner/repo) under a host
= "main"
= "modules"
[]
= "company"
= "team/sub/proj" # nested paths are fine ({owner}/{repo} ≡ {path})
= "ssh" # per-source opt-in to ssh
= "configs"
= ["editor", "lint"]
= ["**/test/**", "**/*.bak"]
# Local source: `path` is a filesystem path used verbatim as the remote, exactly
# like a `git = "/abs/local/checkout"` alias.
[]
= "~/dev/scratch-configs"
= "main"
= "modules"
# Forge source pinned to a tag: the source default ref is `v0.55.0`. A binding may
# override the ref per target (see [targets.tools]), so one source can serve several
# versions at once.
[]
= "junegunn/fzf"
= "v0.55.0"
= ["bin"]
# Literal remote: any https, ssh://, or scp-style URL, unchanged from before.
[]
= "https://github.com/srnnkls/loqui.git"
= "9f1c2ab"
= "languages"
= false
= true
# For a local dev loop, override this source onto a local checkout and live-link
# it via `deploy = "link"` — local-overlay-only. See phora.local.example.toml.
# Url source: one of the four kinds (forge XOR local XOR git XOR url). A url downloads and
# extracts (tar, tar.gz/tgz, zip, or a raw single file named from the URL basename);
# a single top-level dir is auto-stripped, so version-stamped release tarballs need
# no per-version `root`. `branch`/`tag`/`rev`/`root` are rejected on a url source.
[]
= "https://github.com/junegunn/fzf/releases/download/0.55.0/fzf-0.55.0-linux_amd64.tar.gz"
# Optional integrity check, verified before extraction; a mismatch errors.
= "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
# digest = "blake3:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
= ["fzf"]
# Content is imported as a deterministic, content-addressed synthetic git commit:
# identical bytes ⇒ identical commit ⇒ no lock churn.
# A target is a directory artifacts are projected into. `sources` is an explicit
# allow-list: list names to deploy them, or set `[]` (or omit the key) to deploy
# nothing. Manage the list with `phora bind`/`phora unbind`. A `sources` entry is a
# bare source name, or a table that refines how THIS target consumes the source:
# `source` = provenance, `take` = this target's own subset/rename of the offer.
[]
= "~/.config/nvim"
[]
# Alias the `dotfiles` source under a distinct `nvim` identity, then subset its
# offer to just the editor's tree with `take` (the new way a target slices a source).
= { = "dotfiles", = ["nvim/**"] }
# One source feeding one target as two independent slices: distinct identities
# (the table keys) each `take` a different subtree, and `by-source` labels each slice.
[]
= "~/.config"
= "by-source"
[]
= { = "dotfiles", = ["nvim/**"] }
= { = "dotfiles", = ["helix/**"] }
# `take` can rename as it subsets: `{ src = dest }` projects one offered path to a
# new destination name, alongside literal/glob leaves it keeps as-is.
[]
= "~/.config/Code/User"
= "flat"
[]
= { = ["vscode/**", { = "settings.json" }] }
= {}
[]
= "~/.cupcake/policies/claude"
= ["loqui"]
= { = "prefixed", = "/" }
[]
= "~/.local/bin"
= ["fzf-bin"]
= "flat"
# One source pinned to two versions in one project: distinct identities (the table
# keys) each pin their own ref, so a binding's branch/tag/rev overrides the source
# default for that target alone. Each distinct ref gets its own lock entry (at its own
# commit); a bare binding would inherit the source ref and share the source's single entry.
[]
= "~/.local/tools"
= "by-source"
[]
= { = "fzf", = "v0.55.0" }
= { = "fzf", = "v0.56.0" }
# A transitive source's own phora.toml declares its offers; `offer` picks one
# (`default` when omitted).
[]
= "github"
= "srnnkls/tropos"
= true
[]
= "~/.config/fas/rules"
= { = "fas" }