osagent 0.2.73 → 0.2.74

package/dist/README.md

@@ -1,478 +0,0 @@
-# OS Agent
-
-An AI-powered autonomous coding assistant CLI that runs locally with Ollama or connects to cloud AI providers. Built for developers who want full control over their AI coding assistant.
-
-## Features
-
-- **Smart Onboarding**: Auto-detects your system, tools, and project on first run
-- **Local-first AI**: Works with Ollama for completely private, offline usage
-- **Cloud support**: Connect to Ollama Cloud or OpenAI-compatible APIs
-- **Interactive CLI**: Beautiful terminal interface with monochrome green theme
-- **Autonomous coding**: Generate, edit, and refactor code with natural language
-- **Multi-file editing**: Make changes across your entire project
-- **Git integration**: Automatic commits and PR creation
-- **Consultation mode**: AI asks clarifying questions to better understand your needs
-- **Conversation persistence**: Resume previous sessions with `/continue`
-- **System health checks**: Built-in diagnostics with `/doctor`
-- **Extensible**: MCP (Model Context Protocol) support for custom tools
-- **Custom agents**: Define your own specialized agents in `~/.osagent/agents/`
-- **Custom commands**: Create custom slash commands in `~/.osagent/commands/`
-- **Custom skills**: Create skill plugins for multi-step workflows
-- **Multi-agent orchestration**: Automatic skill detection and agent dispatch
-- **Episodic memory**: Session tracking and learning from past interactions
-- **Vector memory**: Semantic search over session history with ChromaDB
-- **Embeddings**: Ollama embeddings with OpenRouter fallback
-- **Advanced hooks**: 12 subagent hooks for lifecycle, memory, and skill events
-
-## Installation
-
-### From npm (recommended)
-
-```bash
-npm install -g osagent
-```
-
-### From source
-
-```bash
-git clone https://github.com/robertohluna/osagent.git
-cd osagent
-npm install
-npm run build
-npm link
-```
-
-### Troubleshooting Installation
-
-**Never use `sudo` with npm!** Using `sudo npm install -g` creates permission problems.
-
-If you see permission errors:
-
-```bash
-# Fix npm cache permissions
-sudo chown -R $(whoami) ~/.npm
-
-# If using nvm, also fix nvm directory
-sudo chown -R $(whoami) ~/.nvm
-
-# Clear npm cache
-npm cache clean --force
-
-# Now install without sudo
-npm install -g osagent
-```
-
-If updates don't take effect (old version showing):
-
-```bash
-npm cache clean --force
-npm install -g osagent@latest --force
-osagent --version
-```
-
-**Recommended: Use nvm** to avoid permission issues entirely:
-
-```bash
-# Install nvm
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
-
-# Restart terminal, then:
-nvm install 20
-nvm use 20
-
-# Now npm never needs sudo
-npm install -g osagent
-```
-
-## Quick Start
-
-### Option 1: Use with Ollama (Local - Recommended)
-
-1. Install [Ollama](https://ollama.com)
-2. Pull a coding model:
-   ```bash
-   ollama pull qwen2.5-coder:32b
-   ```
-3. Run OS Agent:
-   ```bash
-   osagent
-   ```
-
-### Option 2: Use with Ollama Cloud
-
-1. Get an API key from [Ollama Cloud](https://ollama.com)
-2. Set your API key:
-   ```bash
-   export OLLAMA_API_KEY=your-api-key
-   ```
-3. Run OS Agent:
-   ```bash
-   osagent
-   ```
-
-### Option 3: Use with OpenAI-compatible APIs
-
-```bash
-osagent --auth openai
-```
-
-## Usage
-
-### Basic Commands
-
-```bash
-# Start interactive mode
-osagent
-
-# Start with a prompt
-osagent "Explain this codebase"
-
-# Use a specific model
-osagent --model qwen2.5-coder:32b
-
-# Resume last conversation
-osagent --continue
-
-# Print a file and ask about it
-osagent "What does this do?" < src/main.ts
-
-# Run health check
-osagent doctor
-
-# Dangerous mode (auto-accept all tool executions)
-osagent --dangerously
-```
-
-### Slash Commands
-
-Once in the interactive mode, you can use these commands:
-
-#### General
-- `/help` - Show available commands
-- `/about` - Show version and system info
-- `/settings` - View and edit settings
-- `/quit` or `/q` - Exit OS Agent
-
-#### Model & AI
-- `/model` - Switch AI model (supports local Ollama models)
-- `/agents` - Manage custom agents
-- `/consult` - Toggle consultation mode (AI asks clarifying questions)
-
-#### Conversation
-- `/continue` - Resume the most recent conversation
-- `/continue list` - List recent sessions to resume
-- `/reset` - Clear conversation and start fresh
-- `/clear` - Clear the screen
-- `/chat save <tag>` - Save conversation checkpoint
-- `/chat resume <tag>` - Resume from checkpoint
-
-#### Safety & Permissions
-- `/dangerously` or `/yolo` - Toggle auto-accept mode for tool executions
-- `/permissions` - View and manage tool permissions
-
-#### System
-- `/doctor` - Check system health and updates
-- `/doctor update` - Auto-update to latest version
-- `/doctor init` - Initialize `~/.osagent/` directory structure
-- `/view` - View system architecture and configuration
-- `/view config` - Current configuration
-- `/view files` - Configuration files
-- `/view models` - Supported models
-- `/context` or `/ctx` - View context window usage and token stats
-
-#### Utilities
-- `/copy` - Copy last response to clipboard
-- `/memory` - View and edit project memory
-- `/tools` - List available tools
-- `/mcp` - Manage MCP servers
-
-### Status Bar
-
-While OS Agent works, you'll see a real-time status bar showing:
-- Current activity with spinner
-- Token usage (input ↑ / output ↓)
-- Elapsed time
-- Task progress and list
-
-```
-┌─────────────────────────────────────────────────────────┐
-│ ◐ Writing tests for auth module... (2/5)    ↑12.3k ↓8.2k 2m 15s │
-│ ├─ ○ Create test file                                   │
-│ ├─ ◐ Writing unit tests                                │
-│ └─ ○ Run tests and fix errors                          │
-└─────────────────────────────────────────────────────────┘
-```
-
-### Consultation Mode
-
-OS Agent can ask you clarifying questions as it works to better understand your requirements:
-
-```bash
-/consult on        # Active mode - questions shown while agent works
-/consult blocking  # Blocking mode - high-priority questions pause the agent
-/consult off       # Disable consultation
-/consult context   # View collected context
-```
-
-Questions appear in a dedicated panel below the status bar during agent operations.
-
-### Vector Memory (Optional)
-
-For semantic search over session history, start ChromaDB:
-
-```bash
-# Start ChromaDB with Docker
-docker compose -f docker/docker-compose.yml up -d
-
-# Ensure Ollama has the embedding model
-ollama pull nomic-embed-text
-```
-
-### Multi-Agent Orchestration
-
-OS Agent features an intelligent orchestration system that automatically:
-
-- **Detects skills** in your prompts (debugging, testing, refactoring, etc.)
-- **Selects the best agent** for each task based on capabilities
-- **Dispatches execution** to specialized subagents
-- **Tracks progress** with real-time status updates
-
-The orchestrator runs transparently - just describe what you want and OS Agent handles the rest.
-
-### Episodic Memory
-
-OS Agent learns from your sessions:
-
-- **Records episodes** of your interactions automatically
-- **Tracks actions** including tools used and files modified
-- **Saves outcomes** for future reference
-- **Enables recall** of past patterns and solutions
-
-Episodes are stored locally in `~/.osagent/episodes/`.
-
-### Configuration
-
-OS Agent stores its configuration in `~/.osagent/` (created automatically on first run):
-
-```
-~/.osagent/
-├── settings.json       # User settings
-├── agents/            # Custom agent definitions (.md, .yaml, .json)
-├── commands/          # Custom slash commands (.toml)
-├── skills/            # Custom skill plugins (.yaml)
-├── prompts/           # Custom prompts
-└── episodes/          # Episodic memory storage
-```
-
-### Custom Agents
-
-Create custom agents in `~/.osagent/agents/`:
-
-```yaml
-# ~/.osagent/agents/my-agent.yaml
-name: my-agent
-description: A specialized agent for my use case
-systemPrompt: You are an expert in...
-model: qwen2.5-coder:32b
-```
-
-### Project Memory
-
-Create an `OSAGENT.md` file in your project root to give OS Agent context:
-
-```bash
-osagent /init
-```
-
-## Supported Models
-
-### Cloud Models (Ollama Cloud)
-- `qwen3-coder:480b-cloud` - Most powerful (256K context)
-- `qwen3-coder:30b` - Efficient (30B params, 3.3B active)
-
-### Local Models (Ollama)
-- `qwen2.5-coder:32b` - Best local coding model (~20GB VRAM)
-- `qwen2.5-coder:14b` - Great balance (~10GB VRAM)
-- `qwen2.5-coder:7b` - Good for limited VRAM (~5GB)
-- `codellama:34b` - Meta's coding model
-- `deepseek-coder-v2:16b` - Efficient MoE model
-- `llama3.2:latest` - General purpose
-
-## Requirements
-
-- Node.js >= 20.0.0
-- Ollama (for local usage) or API key for cloud providers
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Build all packages
-npm run build
-
-# Run in development mode
-npm run start
-
-# Run tests
-npm run test
-
-# Type check
-npm run typecheck
-
-# Lint
-npm run lint
-```
-
-## Architecture
-
-OS Agent is a monorepo with the following packages:
-
-```
-packages/
-├── cli/          # Terminal UI and user interaction (React/Ink)
-├── core/         # AI engine, tools, and services
-├── test-utils/   # Shared test utilities
-└── vscode-ide-companion/  # VS Code extension
-```
-
-## Keyboard Shortcuts
-
-### General
-- `Ctrl+C` - Cancel current operation / Exit (press twice)
-- `Ctrl+D` - Exit
-- `Escape` - Cancel operation / Clear input
-- `Tab` - Autocomplete commands
-- `Up/Down` - Navigate history
-- `?` - Show shortcuts help
-
-### During Operations
-- `Ctrl+O` - Expand/collapse output
-- `Ctrl+Y` - Toggle todo list visibility
-- `Ctrl+E` - Toggle agent detail level
-- `Ctrl+F` - Focus embedded shell
-
-### Text Editing
-- `Ctrl+L` - Clear screen
-- `Ctrl+A` - Move to start of line
-- `Ctrl+E` - Move to end of line
-- `Ctrl+K` - Delete to end of line
-- `Ctrl+U` - Delete to start of line
-- `Shift+Enter` - Insert newline
-
-## Documentation
-
-For detailed architecture documentation, see [SYSTEM_ARCHITECTURE.md](SYSTEM_ARCHITECTURE.md). This includes:
-- Complete request flow diagrams
-- Agent system and tier structure
-- Skill detection and auto-dispatch
-- Tool system and execution flow
-- Memory systems (episodic + vector)
-- Context provider hierarchy
-- Integration points and key files
-
-## Recent Updates
-
-### v0.2.0 - Architecture & Orchestration Improvements
-- **Roadmap System**: New persistent project tracking system (`roadmap` tool for agents)
-  - Track work items with priorities, dependencies, and subtasks
-  - Stored in `.osagent/roadmap.json` - persists across sessions
-  - Actions: view, add, update, next, summary, note
-- **Consultation Integration**: Enhanced orchestrator-consultation bridge
-  - Generates clarifying questions when prompts are ambiguous
-  - Context-aware question generation based on skill detection
-  - Collects enhanced context for better agent selection
-- **Codebase Cleanup**: Removed orphaned code and redundant hooks
-  - Deleted unused memory command hooks
-  - Consolidated RoadmapContext into core service
-  - Updated architecture documentation
-- **Documentation**: Added comprehensive SYSTEM_ARCHITECTURE.md
-  - Complete system flow documentation
-  - Agent tiers and selection rules
-  - Skill detection process
-  - Tool registration patterns
-
-### v0.1.87 - Test Fixes & Documentation
-- Fixed all test failures (3170/3170 tests now passing)
-- Updated naming consistency across codebase
-- Fixed vision model detection in DashScope provider
-- Added gopd dependency troubleshooting documentation
-- Improved MCP client transport handling
-
-### v0.1.86 - Auto Project Context
-- Automatic project context injection on first prompt
-- When no OSAGENT.md exists, AI auto-explores project structure before responding
-- No manual `/init` required for casual usage
-
-### v0.1.85 - Security & Stability Fixes
-- Timer now only counts active work time (stops when idle)
-- Fixed command injection vulnerability in git co-author feature
-- Fixed symlink bypass in path validation
-- Fixed VimModeContext re-render loop
-
-### v0.1.83 - Enhanced Doctor Command
-- Added enhanced installation diagnostics to `/doctor`
-- Shows installation method (npm-global, homebrew, native, source)
-- Displays binary path and invoked path
-- Shows auto-updates status and search/ripgrep status
-- Detects and warns about multiple installations
-- New "All systems go" summary style
-
-### v0.1.81 - Stability & Auto-Initialization
-- Fixed "Maximum update depth exceeded" infinite loop (3800+ errors)
-- Added automatic `~/.osagent/` directory initialization on startup
-- Creates required directories: agents, commands, prompts, skills, episodes
-- Auth credentials now properly saved when switching providers
-
-### v0.1.80 - Auth Provider Fix
-- Fixed auth configuration mismatch when switching providers
-- Ensures baseUrl and model are saved correctly to settings
-
-### v0.1.79 - IDE Terminal Compatibility
-- Migrated all dialogs from custom `useKeypress` to Ink's `useInput` hook
-- Fixes arrow key issues in VS Code, Cursor, and other IDE terminals
-- Arrow keys no longer print escape sequences (`^[[A^[[B`) in dialogs
-- Improved compatibility with IDE terminals that don't support raw mode
-
-### v0.1.66 - Focus Management
-- New `useFocusedKeypress` hook for enforced focus management
-- Prevents keypress conflicts between dialogs and main UI
-- Required `isFocused` parameter catches bugs at compile time
-
-### v0.1.65 - Input Routing Fix
-- Fixed keyboard input routing issues with selectors
-- Arrow keys and Enter now properly isolated to focused component
-- No more keypress "leakage" between dialogs
-
-### v0.1.64 - UI Improvements
-- Tree-view style tool display with `├─` `└─` connectors
-- Expandable results with `Ctrl+O`
-- Token counts and duration stats
-- Sleeker ASCII art header
-- Minimal init banner
-
-### v0.1.63 - Stability Fix
-- Fixed infinite loop on startup (Maximum update depth exceeded)
-- Improved React effect dependency management
-
-### v0.1.59 - Terminal Stability
-- Fixed EIO error crash on stdin
-- Graceful handling of TTY disconnects
-- Stable arrow key navigation in selectors
-
-See [KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) for detailed issue tracking.
-
-## License
-
-Apache-2.0
-
-## Contributing
-
-Contributions are welcome! Please read our contributing guidelines before submitting PRs.
-
-## Links
-
-- [GitHub](https://github.com/robertohluna/osagent)
-- [npm](https://www.npmjs.com/package/osagent)
-- [Issues](https://github.com/robertohluna/osagent/issues)

package/dist/package.json

@@ -1,40 +0,0 @@
-{
-  "name": "osagent",
-  "version": "0.2.6",
-  "description": "OS Agent - AI-powered CLI for autonomous coding with Ollama Cloud and Qwen models",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/robertohluna/osagent.git"
-  },
-  "type": "module",
-  "main": "cli.js",
-  "bin": {
-    "osagent": "cli.js"
-  },
-  "files": [
-    "cli.js",
-    "vendor",
-    "*.sb",
-    "README.md",
-    "LICENSE",
-    "locales"
-  ],
-  "config": {
-    "sandboxImageUri": "ghcr.io/osagent/osagent:0.1.100"
-  },
-  "dependencies": {
-    "punycode": "^2.3.1"
-  },
-  "optionalDependencies": {
-    "@lydell/node-pty": "1.1.0",
-    "@lydell/node-pty-darwin-arm64": "1.1.0",
-    "@lydell/node-pty-darwin-x64": "1.1.0",
-    "@lydell/node-pty-linux-x64": "1.1.0",
-    "@lydell/node-pty-win32-arm64": "1.1.0",
-    "@lydell/node-pty-win32-x64": "1.1.0",
-    "node-pty": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}