Skip to main content
EllygentAI-assisted Systems Engineering
Login
Start free

CLI / Getting Started

Getting Started

Install the Ellygent CLI from the command line and start downloading AI-ready engineering context in under 5 minutes.

Prerequisites

Node.js LTS and npm

The official Windows installer now uses npm to install the CLI from GitHub. Check with node --version and npm --version before you begin.

An active Ellygent account

Sign up at ellygent.com

Access to at least one organization/project

Ask your organization admin to invite you if needed


Interactive Quickstart

Follow this complete workflow from installation to your first context download:

Terminal
#Install the CLI from the command line
$irm https://ellygent.com/cli/install.ps1 | iex
#Verify installation
$ellygent --help
Show command list and usage
#Login with a Personal Access Token
$ellygent auth login --token <your-personal-access-token>
✓ Logged in with Personal Access Token
$ellygent whoami
Authenticated: yes
#Discover your projects
$ellygent projects --org acme-corp --format markdown
┌─────────────────────┬───────────────────┬──────────────┐
│ Project │ Latest Version │ Specs │
├─────────────────────┼───────────────────┼──────────────┤
│ safety-system │ v2.1 │ 12 │
│ platform-api │ main │ 8 │
└─────────────────────┴───────────────────┴──────────────┘
#Download engineering context
$ellygent sync --project safety-system --version v2.1
⬇ Downloading context package...
✓ Extracted to ./.ellygent/
• 247 requirements
• 89 capabilities
• Full traceability graph

CLI Demo: Authenticate and Download Project Context

Watch a live walkthrough showing how to authenticate with the Ellygent CLI and download structured context from an existing project into a local engineering workflow.

Watch on YouTube

Step-by-Step Guide

1. Install the CLI

Check out the CLI from GitHub, or use the hosted installer wrapper for PowerShell:

# PowerShell wrapper
irm https://ellygent.com/cli/install.ps1 | iex

# Manual GitHub checkout
git clone --depth 1 https://github.com/EEQuality/ellygent-cli.git
Set-Location ellygent-cli
npm install
npm run build
npm install -g .

For command-line installation details and troubleshooting, see the Installation Guide.

2. Verify Installation

Confirm the CLI is installed and accessible:

ellygent --help
ellygent --version
3. Authenticate

Validate your Personal Access Token and store it for CLI use:

ellygent auth login --token <your-personal-access-token>
ellygent whoami
4. Discover Your Projects

List projects in your organization:

ellygent context projects --org <your-org-name> --format markdown

Replace <your-org-name> with your organization slug.

5. Download Engineering Context

Sync a project to your local workspace:

ellygent sync --project <project-id> --version <version>

This creates a .ellygent/ directory with requirements, capabilities, and traceability data.


What You Get

After running ellygent sync, your workspace contains:

.ellygent/
├── requirements/
│   ├── functional_requirements.md
│   ├── safety_requirements.md
│   └── performance_requirements.md
├── capabilities/
│   ├── system_capabilities.md
│   └── feature_capabilities.md
├── metadata.json
└── traceability.json

All files are AI-ready markdown and JSON formats, optimized for code generation tools and LLMs.


Next Steps

Explore all CLI commandsSet up Personal Access Tokens for automationView real-world workflow examplesIntegrate with CI/CD pipelines
Back to CLI HomeNext: Installation