Skip to content
Getting Started

From zero to first AI session

in under 5 minutes

Install the Lurus Code CLI, authenticate your account, and start your first AI-powered coding session — all in a few simple steps.

~5 minutes to first session
1
Install
2
Login
3
First Chat
4
Key Commands
1
Step 1

Install the CLI

The Lurus Code CLI is distributed as an npm package and runs on Node.js 18 or later. A single command installs it globally.

Requirements

🟢 Node.js ≥ 18
📦 npm ≥ 8
💻 OS macOS · Linux · Windows
npm Global installation
npm install -g @scramble-cloud/lurus-code-cli
$ Verify installation
lurus --version
# Expected output: lurus-code/x.y.z
💡

Using pnpm or yarn?

You can also install via pnpm add -g @lurus/code or yarn global add @lurus/code.

2
Step 2

Log in to your account

Lurus Code uses a secure browser-based login flow. No password is ever stored on disk — only an encrypted JWT token.

Choose your login method

Recommended

Browser Login

Opens your default browser for secure OAuth authentication.

lurus login
  1. 1 Run lurus login in your terminal.
  2. 2 Your browser opens automatically.
  3. 3 Sign in with your Lurus Code account.
  4. 4 The CLI receives a token and stores it securely.

Email & Password

Authenticate directly in the terminal.

lurus login --email

API Key

Best for CI/CD pipelines and headless environments.

lurus login --api-key YOUR_KEY

Or use environment variable:

LURUS_API_KEY=your_key lurus chat -p "..."
$ Verify authentication
lurus auth status
# Shows: logged in as user@example.com
Don't have an account yet? Create one with lurus register
3
Step 3

Start your first chat session

Once authenticated, you can start an interactive AI coding session with a single command.

Interactive mode

Launches a full interactive chat session in your terminal.

lurus chat

Type your question and press Enter

Quick single prompt

Send a single prompt and get an immediate response without entering interactive mode.

lurus chat -p "Explain this codebase to me"

Resume last session

Continue exactly where you left off.

lurus chat -c

Try these starter prompts

lurus chat -p "Review my last commit for bugs"

Instant code review

lurus chat -p "Write unit tests for src/utils.ts"

Auto-generate tests

lurus chat -p "Find security vulnerabilities in this file"

Security scan

lurus chat -p "Document all public functions in src/"

Auto-documentation

Useful slash commands inside chat

Type `/` in the chat to see all available commands.
/help Show all available commands
/status Show session info and token usage
/model Switch the AI model
/clear Clear the current context
/review Start a code review
/scan Run a security scan
/test Generate tests for current file
/commit Create a git commit message
/quit Exit the chat session
4
Step 4

Essential commands to know

These are the most important CLI commands you will use day to day.

🔑

Authentication

lurus login
Sign in to your account
lurus logout
Sign out
lurus auth status
Check login status
lurus register
Create a new account
💬

Chat & AI

lurus chat
Start interactive session
lurus chat -p "..."
Single prompt, then exit
lurus chat -c
Resume last session
lurus chat --model claude-3-5-sonnet
Use specific model
⚙️

Management

lurus update
Update CLI to latest version
lurus update --check
Check for updates without installing
lurus completions zsh
Enable shell auto-completion
lurus --version
Show installed version
🚀

CI/CD

lurus security-ci
Headless security scan (exit code 0/1)
lurus code-review-ci
Headless code review for PRs
lurus batch tasks.jsonl
Run multiple prompts from file

What's next?

Now that you have your first session running, explore the full power of Lurus Code.

Ready to start coding with AI?

Install the CLI now and write your first prompt in under 5 minutes.