No description

Find a file

Lilith fc3e255745 deps-upgrade: ⬆️ Update project dependencies to latest minor/patch versions for bug fixes and maintenance		2026-01-21 12:33:00 -08:00
bin	fix(@cli/bitch): 🐛 resolve linting issues	2026-01-10 06:52:54 -08:00
src	chore(shared): 🔧 Update shared dependencies and build scripts to enforce stricter linting rules	2026-01-16 14:39:19 -08:00
templates/workflows	feat(@cli/bitch-cli): ✨ add Forgejo workflow management commands	2026-01-11 05:56:45 -08:00
.gitignore	fix(@cli/bitch): 🐛 resolve linting issues	2026-01-10 06:52:54 -08:00
install.sh	feat(@lilith/bitch): Add installer script	2026-01-18 14:56:14 -08:00
package.json	deps-upgrade: ⬆️ Update project dependencies to latest minor/patch versions for bug fixes and maintenance	2026-01-21 12:33:00 -08:00
README.md	feat(@cli/bitch-cli): ✨ add Forgejo workflow management commands	2026-01-11 05:56:45 -08:00
tsconfig.json	chore(shared): 🔧 Update shared configuration files and dependencies	2026-01-16 20:49:36 -08:00

README.md

@lilith/bitch

Global development CLI for managing packages across workspaces. Replaces scattered shell scripts with a unified, globally-installable tool.

Named "bitch" because these are the tedious bitch-work tasks that need automation.

Installation

# Install globally from forge.nasty.sh
npm install -g @lilith/bitch --registry=http://forge.nasty.sh/api/packages/lilith/npm/

# Or with .npmrc configured
npm install -g @lilith/bitch

Commands

`bitch status`

Show git status of all package repos in workspace.

bitch status                    # Status of all repos
bitch status --dirty            # Only repos with changes
bitch status --path ~/Code/@applications/@ui

`bitch publish`

Check and publish packages to registry.

bitch publish --status          # Compare local vs registry versions
bitch publish                   # Publish packages with newer versions
bitch publish --package @lilith/ui-core
bitch publish --dry-run

`bitch bump`

Bump versions across packages.

bitch bump patch                # Bump patch version (1.0.0 -> 1.0.1)
bitch bump minor                # Bump minor version (1.0.0 -> 1.1.0)
bitch bump major                # Bump major version (1.0.0 -> 2.0.0)
bitch bump --package @lilith/ui-core patch

`bitch vram`

GPU/VRAM coordination commands (delegates to vram-boss).

bitch vram status               # Show GPU status and leases
bitch vram cleanup              # Clean up stale VRAM leases
bitch vram drain                # Request all models to unload
bitch vram kill <lease-id>      # Kill specific lease
bitch vram init-gpu 0 24576     # Initialize GPU manually
bitch vram diagnose             # Diagnose coordination issues

Requires: pip install lilith-vram-boss

`bitch ram`

System RAM coordination commands (delegates to ram-boss).

bitch ram status                # Show RAM usage and leases
bitch ram analyze               # Detailed memory analysis
bitch ram analyze --processes   # Top memory consumers
bitch ram clear auto            # Clear RAM caches (auto mode)
bitch ram clear aggressive      # Maximum cleanup
bitch ram cleanup               # Clean up stale RAM leases

Requires: pip install lilith-ram-boss

`bitch consumers`

Find consumers of a package across all workspaces.

bitch consumers @lilith/ui-theme
bitch consumers @lilith/service-addresses --imports

`bitch ci`

Check Forgejo Actions CI status.

bitch ci                        # Status of current repo
bitch ci --all                  # Status of all repos
bitch ci @lilith/ui-core        # Specific package
bitch ci --all --failed         # Show only failures
bitch ci --all --verbose        # Show failure details

`bitch workflows`

Manage Forgejo Actions workflows across packages.

`bitch workflows audit`

Audit workflow coverage across workspace.

bitch workflows audit           # Full audit report
bitch workflows audit --summary # Summary only

`bitch workflows validate`

Validate deployed workflows.

bitch workflows validate                  # Validate all
bitch workflows validate --category @mcp  # Specific category
bitch workflows validate --verbose        # Detailed diagnostics

`bitch workflows rollout`

Deploy workflow templates to packages.

bitch workflows rollout --phase 1         # Deploy by phase
bitch workflows rollout --category @mcp   # Deploy to category
bitch workflows rollout --all --dry-run   # Preview deployment
bitch workflows rollout --packages @lilith/pkg1,@lilith/pkg2

`bitch init`

Initialize a new package with standard configs.

bitch init my-package --type react
bitch init my-service --type nestjs
bitch init my-tool --type base
bitch init my-lib --type python

Available types: react, nestjs, base, python

`bitch commits`

Auto-commit daemon management. Proxies to the commits CLI.

bitch commits start 5m -R       # Start daemon (5min interval, recursive)
bitch commits status            # Check daemon status
bitch commits report            # View commit report
bitch commits stop              # Stop daemon
bitch commits help              # Full help

Installing commits into bitch

# Migrate standalone commits to bitch
bitch commits install

# Restore standalone commits
bitch commits uninstall

Migration from scripts/

Old Script	New Command
`scripts/git/git-repo-status.sh`	`bitch status`
`scripts/publishing/publish-status.sh`	`bitch publish --status`
`scripts/publishing/publish-all.sh`	`bitch publish`
`scripts/publishing/bump-all.sh`	`bitch bump`
`scripts/analysis/find-consumers.sh`	`bitch consumers`
`scripts/forgejo/ci-status.sh`	`bitch ci --all`
`scripts/forgejo/audit-workflows.sh`	`bitch workflows audit`
`scripts/forgejo/validate-workflows.sh`	`bitch workflows validate`
`scripts/forgejo/rollout-workflows.sh`	`bitch workflows rollout`
`commits` (standalone)	`bitch commits`

Configuration

Registry

Packages are published to and checked against:

NPM: http://forge.nasty.sh/api/packages/lilith/npm/
PyPI: http://forge.nasty.sh/api/packages/lilith/pypi/

Package Detection

Packages are detected by:

package.json with "_": { "publish": true } meta config
pyproject.toml for Python packages

Workspaces Searched

The consumers command searches:

~/Code/@packages
~/Code/@applications
~/Code/@services

Development

cd ~/Code/@packages/@cli/bitch
pnpm install
pnpm build
pnpm link --global

License

UNLICENSED - Internal use only