CLI reference
grekt provides a command-line interface for managing AI artifacts.
Commands
Authentication
- grekt loginLog in to registry
- grekt logoutLog out from registry
- grekt whoamiShow current user
Artifact Management
- grekt initInitialize a project
- grekt addAdd an artifact
- grekt installInstall from lockfile
- grekt removeRemove an artifact
- grekt listList installed artifacts
Registry Operations
- grekt publishPublish an artifact
- grekt infoShow artifact info
- grekt versionsList versions
- grekt outdatedCheck for updates
- grekt upgradeUpgrade outdated artifacts
- grekt deprecateDeprecate a version (Coming Soon)
- grekt undeprecateRemove deprecation (Coming Soon)
Sync & Diagnostics
- grekt syncSync to AI tools
- grekt add-targetAdd AI targets
- grekt remove-targetRemove AI targets
- grekt checkCheck artifact integrity
- grekt configManage configuration
Authoring
- grekt packCreate artifact tarball
- grekt versionAuto-version artifacts
Worktree
- grekt worktree syncSync .grekt/ to a git worktree
Global options
| Option | Description |
|---|---|
-h, --help | Show help for command |
-V, --version | Show version number |
Quick reference
bash
# Artifacts
grekt init # Initialize
grekt add @author/artifact # Add from registry
grekt add @author/artifact@1.0.0 # Add specific version
grekt add github:user/repo # Add from GitHub
grekt add gitlab:user/repo # Add from GitLab
grekt install # Install from lockfile
grekt sync --dry-run # Preview sync
grekt sync # Apply
grekt list # List artifacts
grekt check # Verify integrity
grekt remove artifact # Remove
# Registry
grekt publish ./artifact # Publish
grekt info @author/artifact # Show artifact info
grekt versions @author/artifact # List versions
grekt outdated # Check for updates
grekt upgrade # Upgrade all outdated
grekt upgrade @author/artifact # Upgrade specific
# Targets & Config
grekt add-target # Add AI targets
grekt remove-target # Remove AI targets
grekt config registry set @scope # Configure registry
# Authoring
grekt pack ./artifact # Create tarball
grekt version --dry-run # Preview version bumps
grekt version # Apply version bumps
# Worktree
grekt worktree sync # Sync .grekt/ to a worktree
grekt worktree sync --force # Overwrite without confirmation