mirror of
https://github.com/ksyasuda/dotfiles.git
synced 2026-02-27 12:22:43 -08:00
update
This commit is contained in:
101
.codex/AGENTS.md
101
.codex/AGENTS.md
@@ -21,33 +21,17 @@ Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
|
||||
- New deps: quick health check (recent releases/commits, adoption).
|
||||
- Slash cmds: `~/.codex/prompts/`.
|
||||
- Web: search early; quote exact errors; prefer 2024–2025 sources; fallback Firecrawl (`pnpm mcp:*`) / `mcporter`.
|
||||
- Oracle: run `npx -y @steipete/oracle --help` once/session before first use.
|
||||
- Style: telegraph. Drop filler/grammar. Min tokens (global AGENTS + replies).
|
||||
|
||||
## Screenshots (“use a screenshot”)
|
||||
|
||||
- Pick newest PNG in `~/Desktop` or `~/Downloads`.
|
||||
- Verify it’s the right UI (ignore filename).
|
||||
- Size: `sips -g pixelWidth -g pixelHeight <file>` (prefer 2×).
|
||||
- Optimize: `imageoptim <file>` (install: `brew install imageoptim-cli`).
|
||||
- Replace asset; keep dimensions; commit; run gate; verify CI.
|
||||
|
||||
## Important Locations
|
||||
|
||||
- Blog repo: `~/Projects/steipete.me`
|
||||
- Notes/Runbooks: `~/Projects/manager/docs/` (e.g. `mac-studio.md`, `mac-vm.md`)
|
||||
- OpenAI/Codex limits tracking: `~/Documents/steipete/codex limits.md`
|
||||
- Obsidian vault: `$HOME/Library/Mobile Documents/iCloud~md~obsidian/Documents/steipete-notes`
|
||||
- Sparkle keys: `~/Library/CloudStorage/Dropbox/Backup/Sparkle`
|
||||
- Blog repo: `~/projects/sudacode-blog`
|
||||
- Obsidian Vault: `~/S/obsidian/Vault` (e.g. `mac-studio.md`, `mac-vm.md`)
|
||||
|
||||
## Docs
|
||||
|
||||
- Start: run docs list (`docs:list` script, or `bin/docs-list` here if present; ignore if not installed); open docs before coding.
|
||||
- Follow links until domain makes sense; honor `Read when` hints.
|
||||
- Keep notes short; update docs when behavior/API changes (no ship w/o docs).
|
||||
- Add `read_when` hints on cross-cutting docs.
|
||||
- Model note (2025-11-23): no `gpt-5.1-pro` / `grok-4.1` on Peter’s keys yet.
|
||||
- Model preference: latest only. OK: Anthropic Opus 4.5 / Sonnet 4.5 (Sonnet 3.5 = old; avoid), OpenAI GPT-5.2, xAI Grok-4.1 Fast, Google Gemini 3 Flash.
|
||||
|
||||
## PR Feedback
|
||||
|
||||
@@ -67,7 +51,6 @@ Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
|
||||
- CI red: `gh run list/view`, rerun, fix, push, repeat til green.
|
||||
- Keep it observable (logs, panes, tails, MCP/browser tools).
|
||||
- Release: read `docs/RELEASING.md` (or find best checklist if missing).
|
||||
- Reminder: check `~/.profile` for missing env keys (e.g. `SPARKLE_PRIVATE_KEY_FILE`); Sparkle keys live in `~/Library/CloudStorage/Dropbox/Backup/Sparkle`.
|
||||
|
||||
## Git
|
||||
|
||||
@@ -75,8 +58,6 @@ Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
|
||||
- `git checkout` ok for PR review / explicit request.
|
||||
- Branch changes require user consent.
|
||||
- Destructive ops forbidden unless explicit (`reset --hard`, `clean`, `restore`, `rm`, …).
|
||||
- Remotes under `~/Projects`: prefer HTTPS; flip SSH->HTTPS before pull/push.
|
||||
- Commit helper on PATH: `committer` (bash). Prefer it; if repo has `./scripts/committer`, use that.
|
||||
- Don’t delete/rename unexpected stuff; stop + ask.
|
||||
- No repo-wide S/R scripts; keep edits small/reviewable.
|
||||
- Avoid manual `git stash`; if Git auto-stashes during pull/rebase, that’s fine (hint, not hard guardrail).
|
||||
@@ -88,7 +69,7 @@ Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
|
||||
## Language/Stack Notes
|
||||
|
||||
- Swift: use workspace helper/daemon; validate `swift build` + tests; keep concurrency attrs right.
|
||||
- TypeScript: use repo PM; run `docs:list`; keep files small; follow existing patterns.
|
||||
- TypeScript: use repo PM; keep files small; follow existing patterns.
|
||||
|
||||
## macOS Permissions / Signing (TCC)
|
||||
|
||||
@@ -104,79 +85,7 @@ Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
|
||||
|
||||
## Tools
|
||||
|
||||
Read `~/Projects/agent-scripts/tools.md` for the full tool catalog if it exists.
|
||||
|
||||
### bird
|
||||
|
||||
- X CLI: `~/Projects/bird/bird`. Cmds: `tweet`, `reply`, `read`, `thread`, `search`, `mentions`, `whoami`.
|
||||
- Uses Firefox cookies by default (`--firefox-profile` to switch).
|
||||
|
||||
### sonoscli
|
||||
|
||||
- Sonos CLI: `~/Projects/sonoscli/bin/sonos`. Cmds: `discover`, `status`, `play/pause/stop`, `volume set`, `group`.
|
||||
- SSDP can fail: use `--ip <speaker-ip>`.
|
||||
- Spotify SMAPI: `sonos smapi search --service "Spotify" --category tracks "query"`.
|
||||
|
||||
### peekaboo
|
||||
|
||||
- Screen tools: `~/Projects/Peekaboo`. Cmds: `capture`, `see`, `click`, `list`, `tools`, `permissions status`.
|
||||
- Needs Screen Recording + Accessibility. Docs: `~/Projects/Peekaboo/docs/commands/`.
|
||||
|
||||
### sweetistics
|
||||
|
||||
- X analytics app: `~/Projects/sweetistics`.
|
||||
|
||||
### committer
|
||||
|
||||
- Commit helper (PATH). Stages only listed paths; required here. Repo may also ship `./scripts/committer`.
|
||||
|
||||
### trash
|
||||
|
||||
- Move files to Trash: `trash …` (system command).
|
||||
|
||||
### bin/docs-list / scripts/docs-list.ts
|
||||
|
||||
- Optional. Lists `docs/` + enforces front-matter. Ignore if `bin/docs-list` not installed. Rebuild: `bun build scripts/docs-list.ts --compile --outfile bin/docs-list`.
|
||||
|
||||
### bin/browser-tools / scripts/browser-tools.ts
|
||||
|
||||
- Chrome DevTools helper. Cmds: `start`, `nav`, `eval`, `screenshot`, `pick`, `cookies`, `inspect`, `kill`.
|
||||
- Rebuild: `bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools`.
|
||||
|
||||
### xcp
|
||||
|
||||
- Xcode project/workspace helper for managing targets, groups, files, build settings, and assets; run `xcp --help`.
|
||||
|
||||
### xcodegen
|
||||
|
||||
- Generates Xcode projects from YAML specs; run `xcodegen --help`.
|
||||
|
||||
### lldb
|
||||
|
||||
- Use `lldb` inside tmux to debug native apps; attach to the running app to inspect state.
|
||||
|
||||
### axe
|
||||
|
||||
- Simulator automation CLI for describing UI (`axe describe-ui --udid …`), tapping (`axe tap --udid … -x … -y …`), typing, and hardware buttons. Use `axe list-simulators` to enumerate devices.
|
||||
|
||||
### oracle
|
||||
|
||||
- Bundle prompt+files for 2nd model. Use when stuck/buggy/review.
|
||||
- Run `npx -y @steipete/oracle --help` once/session (before first use).
|
||||
|
||||
### mcporter / iterm / firecrawl / XcodeBuildMCP
|
||||
|
||||
- MCP launcher: `npx mcporter <server>` (see `npx mcporter --help`). Common: `iterm`, `firecrawl`, `XcodeBuildMCP`.
|
||||
|
||||
### gh
|
||||
|
||||
- GitHub CLI for PRs/CI/releases. Given issue/PR URL (or `/pull/5`): use `gh`, not web search.
|
||||
- Examples: `gh issue view <url> --comments -R owner/repo`, `gh pr view <url> --comments --files -R owner/repo`.
|
||||
|
||||
### Slash Commands
|
||||
|
||||
- Global: `~/.codex/prompts/`. Repo-local: `docs/slash-commands/`.
|
||||
- Common: `/handoff`, `/pickup`.
|
||||
Read `~/projects/agent-scripts/tools.md` for the full tool catalog if it exists.
|
||||
|
||||
### tmux
|
||||
|
||||
@@ -195,5 +104,3 @@ Do:
|
||||
|
||||
Avoid: purple-on-white clichés, generic component grids, predictable layouts.
|
||||
</frontend_aesthetics>
|
||||
|
||||
Jiten Reader
|
||||
|
||||
Reference in New Issue
Block a user