@compass-ai/nova 1.0.38 → 1.0.39

package/README.md

@@ -5,7 +5,9 @@
 [![TypeScript](https://img.shields.io/badge/typescript-5.5-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-Nova brings the power of advanced AI language models directly to your terminal. Write code, debug issues, refactor projects, and understand complex codebases using natural language - all without leaving your command line.
+Nova brings the power of advanced AI language models directly to your terminal. Write code, debug issues, refactor projects, and understand complex codebases using natural language — all without leaving your command line.
+
+Part of the [Compass Platform](https://compassap.ai/) ecosystem — sync sessions across CLI, Desktop, and Web.
 
 ## Why Nova?
 
@@ -92,6 +94,12 @@ Nova leverages advanced language models to provide intelligent assistance for:
 ❯ Create a commit for my changes with a descriptive message
 ❯ Help me write a PR description for this feature
 
+# Quick commits with /commit
+❯ /commit
+→ Analyzes staged changes
+→ Generates conventional commit message
+→ Creates commit with one approval
+
 # Testing
 ❯ Write unit tests for the payment processing module
 ```
@@ -103,12 +111,17 @@ During a session, use these slash commands:
 | Command | Description |
 |---------|-------------|
 | `/help` | Show available commands |
-| `/model [name]` | Switch between sonnet, opus, haiku |
-| `/approve [mode]` | Toggle approval modes |
-| `/save [name]` | Save current session |
-| `/load [name]` | Load a saved session |
+| `/model [name]` | Switch between Opus, Sonnet, Haiku |
+| `/commit` | Generate conventional commits from staged changes |
+| `/approve [mode]` | Toggle approval modes (manual/auto/strict) |
 | `/tokens` | View token usage stats |
+| `/cost` | Display estimated API costs |
 | `/undo` | Undo last file operation |
+| `/export` | Export conversation as Markdown/JSON/HTML |
+| `/compact` | Summarize conversation to free context |
+| `/index` | Reindex project for semantic search |
+| `/agents` | Switch to specialized agents |
+| `/config` | View/modify configuration |
 | `/clear` | Clear conversation history |
 | `/exit` | Exit Nova |
 
@@ -158,6 +171,30 @@ Usage: `/fix-issue 123`
 
 See [Custom Commands Documentation](docs/custom-commands.md) for full details.
 
+## Agents & Skills
+
+Nova includes specialized agents for different workflows:
+
+| Agent | Purpose |
+|-------|---------|
+| **Explorer** | Codebase navigation and understanding |
+| **Code Reviewer** | Security and quality analysis |
+| **Debugger** | Error diagnosis and fixes |
+| **Planner** | Architecture and implementation planning |
+
+Switch agents with `/agents` or create custom agents in `agents.md`:
+
+```markdown
+---
+name: security-audit
+model: sonnet-4-20250514
+approval-mode: strict
+---
+Focus on: OWASP Top 10, dependency vulnerabilities, secret detection
+```
+
+Learn more about the Skills ecosystem at [agentskills.io](https://agentskills.io).
+
 ## Configuration
 
 Nova uses a hierarchical configuration system:
@@ -188,11 +225,20 @@ Nova is designed with privacy and security as core principles:
 
 ## AI Model Support
 
-Nova supports multiple AI model providers and configurations. The default setup includes support for state-of-the-art language models with:
-- Large context windows (up to 200K tokens)
-- Streaming responses for real-time feedback
-- Advanced reasoning capabilities
-- Vision and tool use support
+Nova supports multiple AI models — switch anytime with `/model`:
+
+| Model | Best For |
+|-------|----------|
+| **Claude Opus 4.5** | Complex reasoning, architecture decisions |
+| **Claude Sonnet 4.5** | Balanced performance (default) |
+| **Claude Haiku 4.5** | Fast iterations, quick tasks |
+| **Ollama** | Local/private, offline capable |
+| **GLM 4.7, Minimax, Kimi, Gemini** | Alternative providers |
+
+All models support:
+- 200K token context window
+- Streaming responses
+- Vision and tool use
 
 ## Requirements
 
@@ -228,8 +274,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 ## Links
 
 - [npm Package](https://www.npmjs.com/package/@compass-ai/nova)
-- [Report Issues](https://github.com/your-org/nova/issues)
-- [Documentation](docs/README.md)
+- [Report Issues](https://github.com/Compass-Agentic-Platform/nova/issues)
 - [Compass Official](https://compassap.ai/)
 
 ---