@ekstraai/cli
v0.1.0
Published
Ekstra command-line tool — login, manage API keys, and bootstrap projects with AI-assistant context
Maintainers
Readme
@ekstraai/cli
The Ekstra command-line tool. Authenticate, manage API keys, and bootstrap projects with AI-coding-assistant context — all from your terminal.
$ npm install -g @ekstraai/cli
$ ekstra login
$ ekstra initWhat it does
| Command | What |
|---|---|
| ekstra login | 6-digit email code flow. Stores session under ~/.ekstra/session.json. |
| ekstra whoami | Show the current logged-in identity. |
| ekstra logout | Clear the local session. |
| ekstra keys create <name> | Create an API key. Prints the token once. |
| ekstra keys list | List your API keys. |
| ekstra keys revoke <id> | Revoke an API key. |
| ekstra docs | Print the developer context pack (llms-full.txt) to stdout. |
| ekstra docs --open | Open the web docs in your browser. |
| ekstra init | Bootstrap an Ekstra project in the current directory. |
ekstra init — the killer command
Run this in any project directory:
ekstra initIt will:
- Log you in if you're not already (6-digit email code flow)
- Fetch
llms-full.txt(the 886-line developer context pack) and write it toCLAUDE.mdso any AI coding assistant — Claude Code, Cursor, Copilot, Zed, Windsurf — instantly knows how to use the Ekstra API correctly - Create a project API key scoped to this project and store it
in
.ekstra/config.json+.env.local - Add
.ekstra/config.jsonand.env.localto.gitignoreso you don't accidentally commit credentials - Also write
.cursorrulesand.windsurfrulesfor IDE-specific AI assistants - Print next-step copy-paste curls so you can verify the API works in 5 seconds
After ekstra init, ask your AI assistant something like:
Build a parking app that uses the Ekstra curb-rules API.
It will write working code on the first try because it has the entire
Ekstra reference in CLAUDE.md.
Flags
ekstra init Full bootstrap (recommended)
ekstra init --no-key Skip API key creation (for read-only apps)
ekstra init --no-sdk Skip SDK install hint at the endEnvironment
| Var | Default | Purpose |
|---|---|---|
| EKSTRA_BASE_URL | https://ekstra.ai | Override for staging / local dev |
| EKSTRA_API_KEY | (set by init) | Read by SDKs in your project |
Session storage
Session lives at ~/.ekstra/session.json with mode 0600. Project
config + key live at .ekstra/config.json + .env.local in the
project root, both gitignored automatically.
License
Apache-2.0 © Ekstra AI
