Reference
Commands
OpenSyntax supports regular CLI commands and interactive slash commands inside the chat session.
CLI Commands
| Command | Purpose |
|---|---|
opensyntax | Start an interactive coding-agent session. |
opensyntax "fix tests" | Run a one-shot request. |
opensyntax auth | Connect or update an AI provider. |
opensyntax providers | List supported and connected providers. |
opensyntax models [provider] | List model defaults and examples. |
opensyntax doctor | Check provider, config, git, and workspace health. |
opensyntax terminal | Show OS, shell, WSL, Node, and package-manager detection. |
opensyntax permissions [mode] | Show or change saved permission mode. |
opensyntax rules init | Create a starter OPENSYNTAX.md. |
Interactive Slash Commands
| Command | Purpose | Expected output |
|---|---|---|
/help | Show categorized beginner-friendly commands. | Command list. |
/help providers | Show provider/model examples. | Focused help. |
/help sessions | Show session examples. | Focused help. |
/help permissions | Explain permission commands and modes. | Focused help. |
/clear | Clear terminal screen. | Blank screen with prompt. |
/providers | List providers and connection state. | Provider table. |
/provider [id] | Switch active provider. Example: /provider openai. | Provider and model update. |
/model | Show or switch the current session model. | Current model or update message. |
/auth | Show auth state. | Connected providers. |
/login | Connect or update provider. | Setup prompts. |
/logout | Remove provider credentials. | Confirmation prompt. |
/doctor | Check provider, git, and streaming. | Health report. |
/session | List saved sessions. | Session IDs. |
/tools | List agent tools. | Tool names. |
/terminal | Show OS, shell, WSL, Node, and package-manager detection. | Terminal report. |
/os | Show structured OS detection details. | OS JSON. |
/shell | Show detected shell. | Shell name. |
/permissions [mode] | Show or change command/file permission mode. | Permission state. |
/scripts | List package scripts and package-manager commands. | Script list. |
/run <script> | Run a package script with terminal risk checks. | Streaming command output. |
/verify [objective] | Run detected build/typecheck/test verification. | Structured verification summary. |
/shortcuts | Show keyboard shortcuts and raw-mode support. | Shortcut list. |
/command-palette [query] | Search available slash commands. | Command palette results. |
/interrupt / /cancel | Cancel current agent controller and save partial progress. | Interrupt confirmation. |
/command <cmd> | Classify terminal command risk before running. | Risk report. |
/env | Show sanitized runtime environment details. | Masked environment. |
/path | Show PATH entries. | PATH list. |
/plan | Show task plan. | Pending and completed steps. |
/tasks / /todo | Show active task plan. | Task states. |
/progress | Show task completion progress. | Progress report. |
/repo | Summarize package metadata, folders, file types, and git state. | Repository intelligence summary. |
/architecture | Show a compact architecture map. | Important folders and files. |
/dependencies | Show scripts and dependencies from package.json. | Dependency summary. |
/symbols [query] | Search TypeScript and JavaScript symbols. | Symbol list. |
/search / /grep | Search workspace content. | File/line matches. |
/find | Find files by name. | Matching paths. |
/git | Show branch, status, and recent commits. | Git summary. |
/diff | Ask the agent to inspect git diff. | Diff summary. |
/commit | Draft a commit message from current changes. | Commit draft. |
/pr | Draft a pull request outline. | PR draft. |
/auto | Toggle autonomous continuation mode. | Autonomy state. |
/memory / /history | Show persisted session memory summary. | Session stats. |
/plugins | Show built-in tools and workspace plugin manifests. | Plugin summary. |
/rules | Show active OPENSYNTAX.md and AGENTS.md workspace instructions. | Loaded files and effective rules. |
/rules debug | Show loaded paths, merge order, token estimate, and prompt preview. | Debug report. |
/rules reload | Reload instruction files without restarting the CLI. | Updated rule summary. |
/rules open | Open the nearest instruction file, creating one if needed. | Editor/open message. |
/rules init | Create a starter OPENSYNTAX.md. | Created file path. |
/exit | Quit OpenSyntax. | Returns to shell. |
Workspace Instructions
OpenSyntax loads OPENSYNTAX.md, AGENTS.md, .opensyntax/OPENSYNTAX.md, and .opensyntax/AGENTS.md from parent folders to the current workspace. Broader files load first and nearer files override broader guidance.
Instruction files affect prompts, planning, filesystem edits, shell commands, verification behavior, and final responses. Core safety rules always win over workspace instructions.
# OPENSYNTAX.md
## Coding Rules
- Keep edits minimal.
- Use TypeScript only.
## Package Manager
- Use bun only.
## Safety
- Do not edit dist/, build/, coverage/, or node_modules/.