@ouranos/cli — Intelligent Development CLI

What is Ouranos?

Ouranos transforms raw Git history into meaningful engineering intelligence. It watches your code as you work, automatically tracks development sessions, creates verified checkpoints (with health scores), provides visual lineage of your project's evolution, and syncs securely with the cloud for team collaboration.

Think of it as a smart co-pilot for your entire development lifecycle — from the moment you open your editor to the moment you ship.

The Problem

Traditional version control gives you commits. But commits don't tell you:

• How long you actually spent on a task
• Which files changed in that work session
• Whether your code builds and passes tests
• What features were developed together
• How to safely roll back to a known-good state

Ouranos solves all of this and more.

Key Capabilities

| Capability | Description | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | Session Tracking | Automatically detects when you start and stop working. Tracks duration, files touched, and commits made — no manual timers. | | Verified Checkpoints | When your work is done, Ouranos runs your test suite and build to create verified checkpoints with health scores (0-100%). | | Feature Detection | Auto-detects features from your project structure. src/auth/ becomes a feature named "auth". See every feature's evolution across time. | | Intelligent Recovery | Recover specific features, files, or folders from any checkpoint — without losing other work. Includes impact analysis to warn you about broken imports. | | Smart Push | Never fight git conflicts again. Detects divergence and resolves it with configurable strategies (merge, rebase, auto-merge, auto-rebase). | | Daily Reports | Get an at-a-glance summary of your development activity: sessions, commits, features, and health scores. |

Install

npm install -g @ouranos/cli

Quick Start

# Initialize Ouranos in your Git repo
ouranos init

# Start the daemon (auto-watching + auto-commit)
ouranos start

# Check your sessions
ouranos sessions

# List verified checkpoints
ouranos checkpoints

Commands

Session Tracking

ouranos init              # Initialize Ouranos in the current Git repository
ouranos status            # Show Ouranos and Git status
ouranos start             # Start the daemon (background watcher & auto-commit)
ouranos stop              # Stop the running daemon
ouranos sessions          # List recent development sessions
ouranos session current   # Show current session details

Checkpoints & Recovery

ouranos checkpoints                     # List checkpoints for the current project
ouranos features                        # List detected features and their checkpoint lineage
ouranos recover <checkpointId>          # Recover features/files from a checkpoint
ouranos recover <id> -f auth,api        # Recover specific features
ouranos recover <id> --files src/app.ts # Recover specific files

Git Push (Smart)

ouranos push -s merge     # Smart push with conflict resolution strategy
ouranos push-status       # Show divergence status vs remote

Available strategies: merge, rebase, force, wait, auto-merge, auto-rebase, prompt

Daily Reports

ouranos report                              # Generate today's development report
ouranos report 2024-01-15                  # Report for a specific date
ouranos report:range 2024-01-01 2024-01-31 # Report for a date range
ouranos report -f json                     # JSON output

Dashboard & Studio (requires Ouranos Subscription)

ouranos dashboard       # Open the visual dashboard in your browser
ouranos studio          # Launch Ouranos Studio

Cloud Sync (requires Ouranos Subscription)

ouranos login <apiKey>  # Authenticate with Ouranos Cloud
ouranos logout          # Remove stored credentials
ouranos whoami          # Show current cloud authentication status
ouranos sync            # Manually trigger a cloud sync (push + pull)

Cloud Features

Ouranos Cloud extends your local intelligence with secure team collaboration:

| Feature | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------ | | Encrypted Sync | All data synced to the cloud is encrypted with AES-256-GCM. Your code never leaves your machine unencrypted. | | Team Management | Add team members, assign roles, and track collective development metrics. | | SSO Support | Enterprise-grade authentication via SAML 2.0 or OpenID Connect. | | Billing & Plans | Scale from solo developers to entire engineering organizations. | | Cross-device Sync | Resume work seamlessly across your laptop, desktop, and CI environments. | | Release Notes AI | Ouranos auto-generates human-friendly release notes from your checkpoints. |

Visit us at ouranos.dev to learn more about the project.

Architecture

Ouranos is built as a pnpm monorepo with several publishable packages:

packages/
├── core/        # Daemon, engines, EventBus, Express server
├── cli/         # The CLI you're using (this package)
├── git/         # Typed Git operations wrapper
├── api/         # Cloud REST API (PostgreSQL)
├── recovery/    # Feature detection + recovery engine
└── web/         # Studio dashboard (React + D3 + Tailwind)

Local-first by design. The CLI and core engine work entirely offline. Cloud features are optional add-ons that activate when you log in.

License

See LICENSE

This software is proprietary. Unauthorized copying, distribution, or use is strictly prohibited.