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.