Linux-first CLI helper: cli git · cli lint · cli pipeline · cli release.

This README is the long description on PyPI and the GitHub project page — badges link to the same sources of truth on both sites.

Install from PyPI when you only need the tool; clone the repo when you want config and product scripts.

The repo stays cli; only the published distribution name on PyPI is gardusig-cli (cli is taken on PyPI).

Install Python and git with your Linux package manager:

sudo apt-get install python3 git

Optional: gh (GitHub CLI) for cli gh and cli opencode gh workflows.

Cli reads config/config.yaml in the clone, or ~/.config/cli/ after install. Override the directory with CLI_CONFIG_DIR.

Copy the bundled config/ tree and edit paths for your machine before daily use:

Example config.yaml:

backup:
  tags_dir: ~/Library/Mobile Documents/com~apple~CloudDocs/git-tags
  repositories:
    - path: ~/git-local/cli
    - path: ~/git-local/my-other-repo

notion:
  database_id: your-notion-database-id
  task_root: ~/git-local/private/configured/tasks
  pairs_file: config/notion/tasks.pairs.json

chrome:
  profile: Default
  bookmarks_file: ~/git-local/private/bookmarks/bookmarks.html
  downloads_dir: ~/Downloads

Test fixtures (not for production) live under tests/fixtures/notion/tasks and tests/fixtures/bookmarks.html.

Cloud providers: config/drives.yaml. Notion token: export NOTION_TOKEN=... (never commit).

Environment overrides (optional): CLI_BOOKMARKS_FILE, CLI_DOWNLOADS_DIR, CLI_CONFIG_DIR, NOTION_TOKEN.

Install the latest gardusig-cli release from PyPI (no repo clone required):

pip install gardusig-cli
cli --version
cli git --help

Upgrade anytime: re-run pip install gardusig-cli

Config: ~/.config/cli/ (copy config/ from this repo as a starting point; override with CLI_CONFIG_DIR).

Contributors — verification runs in Docker only (cli test python unit ., cli test python integration .).

Run from inside a repository (cd into the repo first).

Short alias: cli g push --yes == cli git push --yes.

Safety: destructive actions (reset, clean, delete, push) require --yes or an interactive confirmation. Default cli git start aligns main then branches; pass --no-prep to branch from the current state.

Local hub: iCloud git-tags/{repo}/{repo}-{tag}.zip (via backup.tags_dir). Cloud: append-only upload to Google Drive and OneDrive (GOOGLE_DRIVE_TOKEN, ONEDRIVE_TOKEN). Proton is deferred.

Typical end-of-day:

cli git tag --yes && cli git zip    # single repo (cwd)
cli drive upload                        # push missing zips to cloud

Multi-repo:

cli drive sync                          # ingest all repos + upload all clouds
# or step by step:
cli drive ingest
cli drive status
cli drive upload

git zip is the quick path for the current repo; drive ingest iterates configured repositories (or one PATH). See docs/drive.md · issue #4.

Bookmark file ingest/deploy (manual browser export/import). See docs/chrome.md · epic #24.

cli chrome bookmarks ingest
cli chrome bookmarks snapshot
cli chrome bookmarks merge --dry-run
cli chrome bookmarks deploy

Google Photos (#50) is deferred — cli chrome photos prints a clear message.

See also docs/bookmarks.md.

Local tasks: notion.task_root (private header/body) + notion.pairs_file (config/notion/tasks.pairs.json). Auth: NOTION_TOKEN + notion.database_id.

See docs/notion.md · epic #2 · children #20–#23.

Local Docker monitor and cleanup (requires docker on PATH; no container start):

Docker cleanup is exposed through cli docker ...; CI Docker stages live in github-pipelines.

Destructive commands use the write gate; pass --yes in scripts.

Requires Docker Engine on Linux. The Linux CI image is the supported test environment.

CI and Docker run outside this repository (central DevOps). This repo has no .github/ workflows or Dockerfile.

Configure release secrets on the central CI system (PYPI_API_TOKEN, TESTPYPI_API_TOKEN). Tag pushes trigger release via repository_dispatch.

Details: docs/release.md · docs/setup.md · docs/ci-workflows.md.

• Setup
• Release
• Git commands
• GitHub (cli gh)
• Drive (local + cloud)
• Chrome · Notion
• Docker integration
• Configuration
• Architecture

• OpenCode — cli opencode AI entry point
• Hub operator — headless ship lane + CI runner
• Cloud drive epic: cli #4
• Bootstrap spec: cli #3
• Chrome: cli #24 · bookmarks #1 superseded
• Docker integration: cli #9