Installation
Terminal tools (Mode 2)
Same hosted MCP as your editor — human-readable output in the shell. Your code stays on disk by default.
Setup guides (CLI first): Connect MCP · CLI without an AI agent · Account & logout · CLI in Docker · Full command reference
Start
Quick start
shell
npx zephex setupcd your-appnpx zephex get-contextnpx zephex find-code "auth middleware"npx zephex outline src/index.tsnpx zephex architectureYou should see Using local project (N files from …) — not a git remote URL. If tools fail with Using Git remote, update: npm install -g zephex@latest.
Guide in the CLI
Built-in guide command
shell
npx zephex cli-guidenpx zephex cli-guide quickstartnpx zephex cli-guide monoreponpx zephex cli-guide remotenpx zephex help terminalMonorepos
Monorepos (repo root vs app package)
From a workspace root (only a top-level package.json), Zephex automatically indexes the package with the most source files (e.g. mcp-proxy/, apps/web/).
shell
# Option A — cd into the appcd mcp-proxy && npx zephex find-code "query" # Option B — from repo rootnpx zephex find-code "query" --cwd mcp-proxynpx zephex outline mcp-proxy/src/cli.tsRemote
Public / private GitHub repos
- Default: uploads an index from the folder on your machine (works offline from git; private code never leaves unless you run the tool).
- Remote:
npx zephex get-context github:owner/repoor--path github:owner/repoon find/read/arch. - Force remote:
--no-local(requires repo access on your Zephex account).
Tools
Terminal MCP tools
| Command | MCP tool |
|---|---|
get-context, framework, … | get_project_context |
find-code, rename, usages | find_code |
summarize, outline, symbol | read_code |
architecture, arch | explain_architecture |
check-package, safe | check_package |
audit-package, upgrade | audit_package |
docs, ask | Zephex_dev_info |
scope-task, think, and reason are available in the terminal CLI. audit_headers is editor-only (HTTP URL audit via MCP after npx zephex setup).
Flags
Important flags
text
--json Raw MCP JSON--cwd <dir> Project / package root--no-local Use git remote instead of local upload--path github:o/r Explicit remote repo--api-key Override saved keyMore
Where to next
- All CLI commands — setup, doctor, keys
- Setup walkthrough
- Troubleshooting