# CLI without an AI agent (Mode 2)

Use `npx zephex` directly in your terminal for the same hosted MCP tools — no Cursor, Claude, or VS Code required.

## Quick start
1. `npx zephex setup` — browser OAuth, writes ~/.zephex
2. `cd` into your app (folder with package.json + src/)
3. `npx zephex get-context` — project snapshot
4. `npx zephex find-code "auth"` — search the repo
5. `npx zephex safe express` — package safety (no repo needed)

## Project detection scenarios
| ID | Situation | Expected |
| --- | --- | --- |
| A | Terminal in app folder (package.json + src/) | Using local project (N files from …) |
| B | Monorepo root (thin workspace package.json) | Auto-pick busiest package; (monorepo) in label |
| C | Private repo on disk | Local inline_files only — no public GitHub required |
| D | Public OSS without clone | get-context github:owner/repo or --path on find/read |
| E | ~, /tmp, or empty folder | No project here — fail fast, do not burn quota |
| F | No API key | Run mcpcli setup or set ZEPHEX_API_KEY |
| G | File path while cwd is wrong | Error names project root; use cd or --cwd |
| H | check-package / loop-guard | Works with no project folder |

## Endpoint
All tools call https://zephex.dev/mcp with your API key from ~/.zephex or ZEPHEX_API_KEY.

## Next docs
- [CLI commands reference](https://zephex.dev/docs/cli-commands)
- [Terminal tools complete guide](https://zephex.dev/docs/terminal-tools-complete-guide)
- [CLI account & logout](https://zephex.dev/docs/cli-account)


Canonical HTML: https://zephex.dev/docs/cli-without-agent