neoncodex CLI v0.1 · npm · Works in VS Code, JetBrains, Terminal

AI in your terminal

Run any NeonCodex task from the command line. Stream output in real time. Pipe results into your workflow.

$npm install -g @neoncodex/cli
Get started →API docs

Install & authenticate

Install globally via npm, then authenticate with your API key from Settings → Developer.

Terminal
$ npm install -g @neoncodex/cli
added 47 packages in 3.2s
 
$ neoncodex login
? Enter your API key: nck_live_••••••••••••••••
✓ Authenticated as Ravi ([email protected])
✓ Config saved to ~/.neoncodex/config.json

Run your first task

Output streams in real time — just like the web interface.

Terminal
$ neoncodex run "Write a Python script to parse JSON and output CSV"
⟳ Creating task... (model: auto → qwen3-coder:free)
 
Here's a Python script to parse JSON and output CSV:
 
```python
import json, csv, sys
 
def json_to_csv(input_file, output_file):
with open(input_file) as f:
data = json.load(f)
...
```
 
✓ Done in 8.3s · 0 credits used · Task ID: 00407436

Commands reference

neoncodex run "<prompt>"--model claude-sonnet-4-6 --no-stream
Run a task and stream output
neoncodex chat--model auto
Start an interactive chat session
neoncodex file <path>--prompt "Summarize this"
Upload a file and analyze it
neoncodex browse <url>--analyze "Find all prices"
Fetch a URL and extract content
neoncodex tasks--limit 20 --status completed
List your recent tasks
neoncodex get <task-id>--output
Get a task by ID (JSON output)
neoncodex stream <task-id>
Stream output of an existing task
neoncodex login--key nck_live_...
Authenticate with your API key
neoncodex logout
Clear saved credentials
neoncodex config--model auto --format markdown
View/set config (model, output format)
neoncodex version
Print CLI version

Pipe into your workflow

Use stdin/stdout to compose NeonCodex with other Unix tools.

Terminal
$ # Pipe a file into a task
$ cat README.md | neoncodex run "Write a blog post based on this"
 
$ # Save output to a file
$ neoncodex run "Generate a REST API spec for a blog" > api-spec.md
 
$ # Chain with git diff
$ git diff HEAD~1 | neoncodex run "Review this diff and suggest improvements"
 
$ # Use with jq for JSON output
$ neoncodex tasks --format json | jq ".[] | .title"

IDE integrations

NEW
VS Code
Extension available

Install the NeonCodex AI extension for inline chat, right-click code actions, Fix/Explain/Security scan, and apply-diff. Or use CLI in the integrated terminal (Ctrl+`).

Download .vsix extension
JetBrains
CLI in terminal

Works in IntelliJ, PyCharm, WebStorm, GoLand via Alt+F12 terminal. Pipe selected code: cat file.py | neoncodex run. Native plugin on roadmap.

$_
Terminal (all)
Available now

Native support for bash, zsh, fish, and PowerShell. Full SSE streaming. Works on macOS, Linux, and Windows (WSL). Install once, works everywhere.

Cursor
Works now

Use NeonCodex CLI in Cursor's integrated terminal alongside Cursor's built-in AI. Best of both worlds: Cursor edits + NeonCodex extended tasks.

Configuration file

Stored at ~/.neoncodex/config.json or per-project at .neoncodex.json.

{
  "apiKey":       "nck_live_xxxxxxxxxxxxxxxxxxxx",
  "model":        "auto",
  "outputFormat": "markdown",
  "stream":       true,
  "baseUrl":      "https://neoncodex.io/api",
  "timeout":      180
}
$ neoncodex run "anything"

Get your API key and start building.

Get API key →API reference