ngodingpakeai

Official command-line client for NgodingPakeAI — the project-memory and codebase-context layer for AI coding agents.

The CLI is the privacy gate: it scans your repo locally, enforces deterministic ignore/secret rules, and syncs only safe context (file tree, languages, structure, and — opt-in — safe code chunks) to a NgodingPakeAI workspace. Secrets, .env files, keys, node_modules, and build output are never uploaded, regardless of configuration.

Install

Run without installing:

npx ngodingpakeai doctor

Or install globally:

npm i -g ngodingpakeai

Requires Node.js >= 18.17.

Authentication

NgodingPakeAI uses access tokens (ngpk_…). The easiest way to authenticate is the browser flow:

ngodingpakeai login

This opens the web app, you approve, and an account-scoped token (valid across all your workspaces) is saved to ~/.ngodingpakeai/config.json (mode 0600).

Headless / CI — pass a token directly (no browser):

ngodingpakeai login --token ngpk_xxxxxxxx

Or skip login entirely and pass credentials via env:

export NGODINGPAKEAI_TOKEN=ngpk_xxxxxxxx
export NGODINGPAKEAI_API_URL=https://www.ngodingpakeai.com   # optional override
ngodingpakeai sync --workspace <workspace-uuid> --yes

Mint a token manually in the web app: Workspace → Settings → Access tokens. The plaintext is shown once — copy it immediately.

Usage

cd your-project

ngodingpakeai connect          # register this folder as a repo in the workspace
ngodingpakeai index            # preview locally what would sync (no upload)
ngodingpakeai sync             # upload codebase context
ngodingpakeai status           # see repos + last sync state

Commands

| Command | Description | | --- | --- | | login | Log in via browser, or --token to save a token headless. | | logout | Remove a stored token (--all for every workspace). | | init | Install the skill for your AI agent (Claude/Codex/Antigravity/Cursor) + AGENTS.md. | | connect | Register the current folder as a repo (detects git remote / provider). | | index | Local scan → .ngodingpakeai/index/latest.json. No network. | | sync | Scan and upload file metadata. --full-code also uploads safe code chunks. | | status | List workspace repos and their latest sync run. | | plan get <id> | Print a plan's PRD (markdown) for agent context. | | task list | Discover open tasks across your plans (--json for scripting). | | task get <id> | Print a task's full prompt to run. | | task start\|complete\|fail <id> | Update a task's status. | | task reset <id> [reason] | Return a task to todo; completed tasks ask for confirmation. | | disconnect | Unbind this folder (server data untouched). | | doctor | Diagnose environment, auth, and connectivity. |

AI agent workflow

init installs a skill so your coding agent (Claude Code, Codex, Cursor, Antigravity) knows how to pull plans and tasks from NgodingPakeAI:

ngodingpakeai init             # auto-detects your agent; writes the skill + AGENTS.md
ngodingpakeai plan get <id>    # PRD context for a plan
ngodingpakeai task list        # find open work
ngodingpakeai task get <id>    # the prompt to run, then start/complete/fail it

Privacy modes

• Basic (default): uploads file tree, languages, sizes, structure, and ignore warnings — not raw source.
• Full Code Context (--full-code): also uploads safe code chunks for richer AI answers. Requires confirmation; secrets and ignored files are still blocked. Embeddings are generated server-side.

What never leaves your machine

Hard-blocked regardless of .gitignore / .ngodingpakeaiignore:

.env, .env.*        node_modules/      dist/ build/ out/ .next/ ...
*.pem *.key *.p12   .git/              coverage/ logs/ *.log
*.sqlite *.db       vendor/ .venv/     (+ files containing detected secrets)

Add project-specific exclusions in .ngodingpakeaiignore (gitignore syntax, created automatically on first connect).

Local config

• ~/.ngodingpakeai/config.json — API url + per-workspace tokens (secret, 0600).
• <project>/.ngodingpakeai/config.json — workspace/repo binding (ids only; safe to commit).

Environment variables

| Variable | Purpose | | --- | --- | | NGODINGPAKEAI_TOKEN | Access token override (CI/headless). | | NGODINGPAKEAI_API_URL | API base url override. | | NGODINGPAKEAI_YES=1 | Auto-confirm prompts. | | NGODINGPAKEAI_DEBUG=1 | Print full stack traces on error. |

Development

pnpm install
pnpm build          # bundle to dist/ (tsup, ESM, with shebang)
pnpm typecheck
node dist/index.js --help

License

MIT