NAVADA Edge CLI

An AI agent that lives in your terminal. It learns who you are, remembers your conversations, and has full access to your machine — files, shell, Python, code execution, and more. Type naturally and it does the work.

npm install -g navada-edge-cli

navada> create a Python script that analyses my CSV data and generate a chart
  [write_file] {"path":"analyse.py","content":"import pandas as pd..."}
  [python_exec] {"code":"..."}

  NAVADA
  Done. Created analyse.py and ran it — chart saved to output.png.
  Your CSV has 1,247 rows across 8 columns. Revenue peaked in March.

Table of Contents

• What is This?
• Installation
• Quick Start
• How It Works
• Memory System
• Tools
• Skills
• AI Providers
• Automation Pipeline
• Configuration
• Commands
• The Vision
• Built By
• License

What is This?

A terminal is the text interface to your computer. Every server, every cloud platform, every CI/CD pipeline runs on terminals. The NAVADA Edge CLI turns your terminal into a conversational AI agent — one that understands what you want and has the tools to do it.

What makes it different:

• 3-tier memory — the agent remembers you across sessions. Your preferences, your projects, your patterns. It gets better the more you use it.
• Full tool access — shell commands, file operations, Python execution, screenshots, web search. The agent doesn't just talk — it acts.
• Bring your own model — use NVIDIA (free), Anthropic, OpenAI, Google Gemini, or HuggingFace. All providers get the same tools.
• Automation pipeline — describe what you want automated and the NAVADA team sets it up on 24/7 cloud infrastructure.
• soul.md + guardrails — configure who the agent thinks you are and what boundaries it respects. Your agent, your rules.

Installation

Requires Node.js 18+.

npm install -g navada-edge-cli
navada

That's it. The free tier uses NVIDIA AI models — no API key required. Install and start talking.

Verify

navada --version
# navada-edge-cli v4.0.0

Quick Start

# Install and launch
npm install -g navada-edge-cli
navada

# The agent is ready. Just type:
navada> what files are in my current directory?
navada> create a Node.js server that returns "hello world" on port 3000
navada> explain what this Python script does
navada> take a screenshot of my screen

# Run the setup wizard for full personalisation
navada> /setup

First-time setup

navada> /setup

This walks you through:

1. API key — free tier works without one, or add your own for unlimited
2. soul.md — tell the agent who you are, what you do, what stack you use
3. guardrail.md — set safety boundaries (what the agent can and can't do)
4. Theme — dark, crow, matrix, or light

After setup, the agent knows you. It loads your soul.md on every interaction and respects your guardrails.

How It Works

When you type a message, here's what happens:

You type: "create a React component for a login form"
     |
     v
  Input Parser
  +-- Starts with /  -->  Slash command (direct execution)
  +-- Natural language  -->  AI Agent pipeline
         |
         v
  Memory Injection
  +-- Tier 1: Working memory (current conversation + summary)
  +-- Tier 2: Recent episodes (what you discussed yesterday)
  +-- Tier 3: Knowledge (you prefer TypeScript, use Next.js)
         |
         v
  Provider Selection (NVIDIA free, Anthropic, OpenAI, Gemini, etc.)
         |
         v
  Tool Execution Loop
  +-- AI decides: write_file --> create LoginForm.tsx
  +-- AI decides: shell --> npm install @shadcn/ui
  +-- AI reads results, continues reasoning
  +-- Repeat until task is complete (up to 10 iterations)
         |
         v
  Response streams token-by-token to your terminal
         |
         v
  Auto-extract: saves preferences and facts to memory

The agent uses a tool-use loop: the AI decides which tool to call, the CLI executes it on your machine, sends the result back, and the AI continues. This means it can chain multiple operations — read a file, modify it, run tests, fix errors — all in one response.

Memory System

The agent has a 3-tier memory that works invisibly. You never manage it — it just gets smarter.

Tier 1: Working Memory (in-session)

• Last 20 full messages kept in buffer
• Older messages compressed into rolling summary
• Auto-summarises every 15 turns to prevent context overflow
• Dies when you close the terminal (but auto-saved as episode)

Tier 2: Episodic Memory (cross-session)

• Every meaningful session is auto-saved as an episode
• Episodes have timestamps, tags, and summaries
• "What did we work on yesterday?" — the agent actually knows
• Stored in ~/.navada/memory/episodes/

Tier 3: Semantic Knowledge (permanent)

• Facts, preferences, skills, people — auto-extracted from conversations
• TF-IDF search (pure JavaScript, zero dependencies)
• "I prefer TypeScript" — saved permanently, used in every future session
• Stored in ~/.navada/memory/knowledge.json

How it feels

Session 1:

navada> I'm a frontend developer, I use React and TypeScript
NAVADA: Got it. I'll keep that in mind.

Session 2 (next day):

navada> help me build a component
NAVADA: Since you use React with TypeScript, here's a typed functional component...

The agent loaded your preference from Tier 3 knowledge. You never asked it to remember — it just did.

Tools

The agent has 16 tools across 7 categories. Every tool works with every AI provider.

Bash

| Tool | What it does | |---|---| | shell | Execute any shell command (bash, PowerShell, cmd) | | python_exec | Run Python code inline | | python_pip | Install Python packages | | python_script | Run .py script files | | sandbox_run | Sandboxed code execution (JavaScript, Python, TypeScript) |

System

| Tool | What it does | |---|---| | read_file | Read any file on your machine | | write_file | Create or edit files | | list_files | Browse directories | | system_info | CPU, RAM, disk, OS, hostname |

Data

| Tool | What it does | |---|---| | web_search | Search the web for information |

Communication

| Tool | What it does | |---|---| | automation_request | Submit automation requests (emails, campaigns, builds) |

Memory

| Tool | What it does | |---|---| | save_memory | Explicitly save something to long-term knowledge | | recall_memory | Search across all memory tiers |

Perception

| Tool | What it does | |---|---| | screenshot | Capture your screen | | describe_image | AI-powered image analysis |

Info

| Tool | What it does | |---|---| | founder_info | About the NAVADA founder |

Skills

The agent can perform complex, multi-step tasks. These are not commands — just describe what you need.

Code Generation — write, debug, refactor code in any language. Full project scaffolds with configs.

Data Analysis — process CSV, JSON, Excel with Python/pandas. Generate charts and visualisations.

Automation — submit requests for 24/7 automation: marketing emails, scheduled reports, data pipelines.

DevOps — Docker builds, git workflows, package management, CI/CD pipelines.

Research — web search, technical docs, competitive analysis, summarisation.

Content — blog posts, emails, documentation, diagrams (Mermaid, SVG, HTML).

Learning — interactive tutorials: /learn python, /learn node, /learn csharp. Code review and architecture design.

AI Providers

Bring your own model. All providers get full tool access.

| Provider | Key Prefix | Models | Cost | How to activate | |---|---|---|---|---| | NVIDIA (default) | nvapi-... | Llama 3.3, DeepSeek R1, Mistral + 5 more | Free (rate limited) | Default — no key needed | | Anthropic | sk-ant-... | Claude Sonnet 4 | Paid | /login sk-ant-xxx | | OpenAI | sk-... | GPT-4o, GPT-4o-mini | Paid | /login sk-xxx | | Google Gemini | AIza... | Gemini 2.0 Flash | Free | /login AIzaxxx | | HuggingFace | hf_... | Qwen Coder 32B | Free | /login hf_xxx |

Unlimited access

The free NVIDIA tier has rate limits. For unlimited access:

navada> /register       # Create account with name + email
navada> /setup          # Complete soul.md + guardrails

This unlocks full access including automation requests and priority support.

Automation Pipeline

Describe what you want automated. The NAVADA team reviews your request and sets it up on 24/7 cloud infrastructure.

navada> /automate Send a weekly marketing email to my leads every Monday

How it works

1. You submit — via /automate or by asking the agent naturally
2. Request queued — goes to the NAVADA Edge operations team
3. Team reviews — Lee (founder) personally reviews and configures your automation
4. You get notified — email confirmation when it's live
5. Track metrics — view status and results on your dashboard

What can be automated

• Marketing email campaigns and newsletters
• Scheduled reports and data exports
• Application builds and deployments
• Data scraping and processing pipelines
• Custom recurring tasks

navada> /automate --type marketing Build me a weekly newsletter template
navada> /automate --type data --schedule daily Scrape competitor prices from 3 sites
navada> /requests     # View all your submitted requests

Configuration

All config lives in ~/.navada/:

~/.navada/
+-- config.json          # API keys, theme, model preferences
+-- soul.md              # Your identity (who you are, your goals)
+-- guardrail.md         # Safety boundaries (what the agent can do)
+-- agent.md             # Custom agent personality (optional)
+-- README.md            # Your workspace quickstart
+-- agents/              # Custom sub-agent personas
+-- memory/
|   +-- knowledge.json   # Tier 3: permanent knowledge base
|   +-- episodes/        # Tier 2: session summaries
+-- conversations/       # Saved full conversations
+-- requests/            # Local automation request queue

Key commands

navada> /setup           # Full setup wizard
navada> /soul            # View your soul.md
navada> /soul edit       # Edit in your default editor
navada> /guardrails      # View boundaries
navada> /guardrails edit # Edit boundaries
navada> /tools           # Show all agent tools
navada> /skills          # Show what the agent can do
navada> /config          # Show all settings
navada> /login <key>     # Set API key (auto-detects provider)
navada> /theme crow      # Switch theme

Commands

68 commands organised by category. Use /help inside the CLI for the full list.

Core

| Command | Description | |---|---| | /help | Show all commands | | /setup | Full onboarding wizard | | /tools | Show agent tools by category | | /skills | Show what the agent can do | | /login <key> | Set API key | | /register | Create NAVADA Edge account | | /config | Show configuration |

AI & Chat

| Command | Description | |---|---| | /chat <msg> | Chat with the agent | | /model [name] | Show or set AI model | | /nvidia models | List free NVIDIA models | | /clear | Reset conversation | | /save [name] | Save conversation | | /load <name> | Load saved conversation | | /retry | Resend last message | | /tokens | Session token usage |

Automation

| Command | Description | |---|---| | /automate <desc> | Submit automation request | | /requests | View your requests |

Edge Network

| Command | Description | |---|---| | /edge login <key> | Connect to NAVADA Edge | | /edge status | Check connection | | /edge tier | Show tier and limits | | /edge usage | View usage stats | | /onboard | Open portal in browser |

Identity

| Command | Description | |---|---| | /soul | View soul.md | | /soul edit | Edit soul.md | | /guardrails | View guardrail.md | | /guardrails edit | Edit guardrail.md | | /agent list | List sub-agents | | /agent use <name> | Activate sub-agent |

Learning

| Command | Description | |---|---| | /learn python | Python interactive tutor | | /learn node | Node.js interactive tutor | | /learn csharp | C# interactive tutor | | /learn off | Exit learning mode |

System

| Command | Description | |---|---| | /theme [name] | Switch theme | | /history | Command history | | /alias <name> <cmd> | Create shortcut | | /export <file> | Save output to file | | /version | Version info | | /upgrade | Check for updates |

The Vision

This is the early stage of an AI-powered operating system layer.

Today, the CLI is a terminal agent — install it, talk naturally, and it works on your machine. But the terminal is just the first interface.

Where this is going:

• Memory that compounds — the longer you use it, the better it understands you. Your agent becomes uniquely yours.
• Automation marketplace — submit what you need, get it running on cloud infrastructure. Email campaigns, data pipelines, scheduled reports — all managed for you.
• Local LLM execution — run models on your own GPU instead of cloud APIs. Same interface, zero cost.
• Sub-agents — specialised personas for security, data engineering, marketing, DevOps. Switch between them with /agent use.
• Multi-device — same agent, same memory, across terminal, web, and mobile.

The operating system analogy

An OS manages hardware and provides an interface. NAVADA Edge does the same for AI:

• Hardware layer — your machine + cloud infrastructure
• Memory layer — 3-tier system that persists across sessions
• Agent layer — AI that understands intent and orchestrates tools
• Interface layer — CLI today, web and mobile tomorrow

The CLI is the shell. The agent is the kernel. Memory is the filesystem. Everything else is a service.

NAVADA Edge Ecosystem

| Package | Install | Purpose | |---|---|---| | navada-edge-cli | npm i -g navada-edge-cli | AI agent in your terminal | | navada-edge-sdk | npm i navada-edge-sdk | SDK for Node.js applications | | Edge Portal | portal.navada-edge-server.uk | Account management and API keys |

Built By

Leslie (Lee) Akpareva — Principal AI Consultant, MBA, MA. 17+ years in enterprise IT, insurance, and AI infrastructure.

• GitHub: github.com/leeakpareva
• Website: navada-lab.space

License

MIT — Leslie Akpareva / NAVADA