Glyph is currently a Go CLI prototype. The public GitHub mirror is Illusion47586/glyph. In this repository, GitHub is the export target; .glyph/ is the local source-control store.
go test ./...
go run ./cmd/glyph init --json
go run ./cmd/glyph import . --json
go run ./cmd/glyph status --json
If you want a local glyph binary during development:
go build -o ./bin/glyph ./cmd/glyph
./bin/glyph status --json
To install the built binary into your user PATH:
./bin/glyph install
When using an installed or locally built glyph binary, the same command shape is:
glyph init --json
glyph import . --json
glyph work start docs-update --from public --json
glyph write docs-update README.md --reason "update readme" --json < README.md
glyph diff docs-update --json
glyph checkpoint docs-update --message "readme ready" --json
glyph publish docs-update --to public --mode squash --json
glyph work prune docs-update --json
That loop is the first important difference from Git. A branch normally has to stand in for “task”, “scratch space”, “review candidate”, and sometimes “visibility boundary.” Glyph separates those steps: work happens in a work context, progress can be checkpointed, and publication is the explicit moment a realm changes.

Inspect The Mesh

Generate the local visualizer:
go run ./cmd/glyph viz export --json
Open:
.glyph/visualizer/index.html

Export To Git

Glyph can export the public realm to a clean Git repository:
go run ./cmd/glyph export git --realm public --out /tmp/glyph-export --json
GitHub sync is configured through Glyph remotes:
go run ./cmd/glyph remote list --json
go run ./cmd/glyph check public --json
go run ./cmd/glyph remote sync origin --json

Important Bootstrap Rule

Do not run git init in this project root while dogfooding Glyph. GitHub is an export target; .glyph/ is the local source-control store. For complete flows, see Workflow Reference. For the full CLI surface, see Command Reference.