| type | skill |
| name | bapxaura-cli |
| description | Use bapXaura CLI for ALL file/content/db operations. Never use raw shell/edit/write/find/grep tools directly. |
bapXaura CLI
All project operations go through bapXaura. This ensures every operation is auditable, logged, and consistent.
Generic File Operations
| Operation | CLI Command |
|---|
| Read file | bapXaura read file <path> |
| Write file | bapXaura write file <path> (pipe stdin) |
| Edit file | bapXaura edit <path> <search> <replace> |
| Search code | bapXaura grep <pattern> [path] |
| Find files | bapXaura find <glob-pattern> |
| Run command | bapXaura run <command...> |
| List dir | bapXaura run ls <path> |
Content CRUD
bapXaura read blog
bapXaura read blog <slug>
bapXaura write blog [slug]
bapXaura read docs [slug]
bapXaura write docs [slug]
bapXaura read product
bapXaura read product <slug>
bapXaura write product [slug]
Database
bapXaura db query products --limit 5
bapXaura db find orders ord_123
bapXaura db raw "SELECT * FROM ..."
bapXaura db init
bapXaura db sync
Project Management
bapXaura test
bapXaura update
bapXaura ci
bapXaura check
bapXaura serve
bapXaura map:gen
bapXaura docsmap
bapXaura codemap
bapXaura schema list
bapXaura hooks install
bapXaura hooks status
bapXaura tui
bapXaura help
Run the smallest useful validation for the change:
```bash
bapXaura lint path/to/changed.php
bapXaura update
bapXaura ci
Telemetry & Ops
Handoffs and telemetry live under .agents/:
bapXaura handoff next <issue>
bapXaura handoff validate <file>
Cycle data is tracked in .agents/ops/telemetry.json.
Use plain git for branches, commits, fetch, pull, and push. GitHub Actions
and the GitHub web interface own issue/PR/handoff conversations. The hosted
server does not require gh.
Attachments
When a coding agent attaches screenshots, images, or files, they go into .agents/temp/. This is the standard inbox for all user-provided attachments in this repo.
bapXaura run ls .agents/temp/
bapXaura read file .agents/temp/<file>
Browser Agent (headless browser automation)
bapXaura browser-agent open <url>
bapXaura browser-agent click <selector>
bapXaura browser-agent fill <selector> <value>
bapXaura browser-agent submit [selector]
bapXaura browser-agent snapshot
bapXaura browser-agent smoke <url>
bapXaura browser-agent screenshot [file]
bapXaura browser-agent config set <k> <v>
bapXaura browser-agent log
bapXaura browser-agent count <tag>
bapXaura browser-agent close
bapXaura browser-agent --pw <command>
Missing Commands
If a required operation is missing or unsafe, enhance the nearest existing bapXaura command before performing the operation. Never use raw bash/write/edit/find tools for operations that have a bapXaura equivalent.