Jason Woltje
6a84f7e210
Co-authored-by: Jason Woltje <jason@diversecanvas.com> Co-committed-by: Jason Woltje <jason@diversecanvas.com>
61 lines
1.6 KiB
Markdown
61 lines
1.6 KiB
Markdown
# Machine-Level Tool Reference
|
|
|
|
Centralized reference for tools, credentials, and CLI patterns available across all projects.
|
|
Project-specific tooling belongs in the project's `AGENTS.md`, not here.
|
|
|
|
## Mosaic Git Wrappers (Use First)
|
|
|
|
Mosaic wrappers at `~/.config/mosaic/rails/git/*.sh` handle platform detection and edge cases. Always use these before raw CLI commands.
|
|
|
|
```bash
|
|
# Issues
|
|
~/.config/mosaic/rails/git/issue-create.sh
|
|
~/.config/mosaic/rails/git/issue-close.sh
|
|
|
|
# PRs
|
|
~/.config/mosaic/rails/git/pr-create.sh
|
|
~/.config/mosaic/rails/git/pr-merge.sh
|
|
|
|
# Milestones
|
|
~/.config/mosaic/rails/git/milestone-create.sh
|
|
|
|
# CI queue guard (required before push/merge)
|
|
~/.config/mosaic/rails/git/ci-queue-wait.sh --purpose push|merge
|
|
```
|
|
|
|
## Code Review (Codex)
|
|
|
|
```bash
|
|
# Code quality review
|
|
~/.config/mosaic/rails/codex/codex-code-review.sh --uncommitted
|
|
|
|
# Security review
|
|
~/.config/mosaic/rails/codex/codex-security-review.sh --uncommitted
|
|
```
|
|
|
|
## Git Providers
|
|
|
|
| Instance | URL | CLI | Purpose |
|
|
|----------|-----|-----|---------|
|
|
| (add your git providers here) | | | |
|
|
|
|
## Credentials
|
|
|
|
**Location:** (configure your credential file path)
|
|
|
|
**Never expose actual values. Never commit credential files.**
|
|
|
|
## CLI Gotchas
|
|
|
|
(Add platform-specific CLI gotchas as you discover them. Examples: TTY requirements, default list limits, API fallback patterns.)
|
|
|
|
## Custom Tools
|
|
|
|
(Add any machine-specific tools, scripts, or workflows here.)
|
|
|
|
## Safety Defaults
|
|
|
|
- Prefer `trash` over `rm` when available — recoverable beats gone forever
|
|
- Never run destructive commands without explicit instruction
|
|
- Write it down — "mental notes" don't survive session restarts; files do
|