Skip to main content

Project storage

PathOwnershipPurpose
.saggar/project.jsonSharedProject name, emoji, and documentation folder
.saggar/commands.mdSharedCommands and startup roles
.saggar/jobs/*.jsonSharedScheduled jobs
.saggar/scratchpad.mdOne checkoutWorking notes and handoff context
.saggar/state.local.jsonOne MacMachine-local project state

Commit shared files when they are useful to everyone working in the repository. Ignore checkout-local and machine-local files with:

.saggar/**/*.local.*
.saggar/scratchpad.md

User-global state lives under ~/.saggar/. Credentials and grants remain in the login Keychain. See .gitignore and .saggar for the rationale.