Skip to content
Star

Offline mode

grekt works without a registry. You can add artifacts from local paths or GitHub/GitLab repositories and sync them to your AI tools directly.

Workflow

bash
grekt init
grekt add ./my-artifacts/code-review
grekt add github:org/repo
grekt sync

That's it. No account, no registry, no network dependency beyond the initial fetch.

Available commands

CommandStatus
initAvailable
addLocal paths, GitHub, GitLab
syncAvailable
listAvailable
removeAvailable
scanAvailable
installSkips local artifacts (installs remote ones normally)
upgradeNot available
outdatedNot available
publishNot available

Limitations

  • No versioning or update detection for GitHub/GitLab sources
  • No deterministic installs across machines. Local paths are machine dependent
  • No lockfile resolution for local sources
  • No raw HTTP/HTTPS URL support as source type
  • grekt install skips local artifacts (they can't be reproduced from a lockfile)
  • In CI environments (CI env var or --ci flag), local artifacts cause a hard error

When to use it

Offline mode is a good fit for:

  • Solo developers managing local artifacts
  • Quick prototyping before setting up a registry
  • Air-gapped environments

For team collaboration, versioning, and reproducible installs, use a registry.