osagent 0.2.78 → 0.2.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +24 -149
  2. package/cli.js +915 -521
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # OS Agent
1
+ # osagent
2
2
 
3
3
  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.
4
4
 
@@ -93,7 +93,7 @@ npm install -g osagent
93
93
  ```bash
94
94
  ollama pull qwen2.5-coder:32b
95
95
  ```
96
- 3. Run OS Agent:
96
+ 3. Run osagent:
97
97
  ```bash
98
98
  osagent
99
99
  ```
@@ -105,7 +105,7 @@ npm install -g osagent
105
105
  ```bash
106
106
  export OLLAMA_API_KEY=your-api-key
107
107
  ```
108
- 3. Run OS Agent:
108
+ 3. Run osagent:
109
109
  ```bash
110
110
  osagent
111
111
  ```
@@ -117,7 +117,7 @@ npm install -g osagent
117
117
  ```bash
118
118
  export ANTHROPIC_API_KEY=your-api-key
119
119
  ```
120
- 3. Run OS Agent:
120
+ 3. Run osagent:
121
121
  ```bash
122
122
  osagent --auth anthropic
123
123
  ```
@@ -129,7 +129,7 @@ npm install -g osagent
129
129
  ```bash
130
130
  export GROQ_API_KEY=your-api-key
131
131
  ```
132
- 3. Run OS Agent:
132
+ 3. Run osagent:
133
133
  ```bash
134
134
  osagent --auth groq
135
135
  ```
@@ -175,7 +175,7 @@ Once in the interactive mode, you can use these commands:
175
175
  - `/help` - Show available commands
176
176
  - `/about` - Show version and system info
177
177
  - `/settings` - View and edit settings
178
- - `/quit` or `/q` - Exit OS Agent
178
+ - `/quit` or `/q` - Exit osagent
179
179
 
180
180
  #### Model & AI
181
181
  - `/model` - Switch AI model (opens model selector)
@@ -184,7 +184,7 @@ Once in the interactive mode, you can use these commands:
184
184
  - `/model <id>` - Switch to a specific model
185
185
  - `/provider` - Switch AI provider (Ollama, Anthropic, GROQ, OpenAI)
186
186
  - `/agents` - Manage custom agents
187
- - `/consult` - Toggle consultation mode (AI asks clarifying questions)
187
+ - `/consult` - Manage consultation mode (AI asks clarifying questions)
188
188
 
189
189
  #### Conversation
190
190
  - `/continue` - Resume the most recent conversation
@@ -216,7 +216,7 @@ Once in the interactive mode, you can use these commands:
216
216
 
217
217
  ### Status Bar
218
218
 
219
- While OS Agent works, you'll see a real-time status bar showing:
219
+ While osagent works, you'll see a real-time status bar showing:
220
220
  - Current activity with spinner
221
221
  - Token usage (input ↑ / output ↓)
222
222
  - Elapsed time
@@ -233,16 +233,18 @@ While OS Agent works, you'll see a real-time status bar showing:
233
233
 
234
234
  ### Consultation Mode
235
235
 
236
- OS Agent can ask you clarifying questions as it works to better understand your requirements:
236
+ osagent can ask you clarifying questions as it works to better understand your requirements:
237
237
 
238
238
  ```bash
239
- /consult on # Active mode - questions shown while agent works
239
+ /consult active # Active mode - questions shown while agent works
240
240
  /consult blocking # Blocking mode - high-priority questions pause the agent
241
- /consult off # Disable consultation
241
+ /consult status # Show current consultation mode and stats
242
242
  /consult context # View collected context
243
+ /consult clear # Clear collected consultation context
244
+ /consult demo # Run a demonstration of consultation features
243
245
  ```
244
246
 
245
- Questions appear in a dedicated panel below the status bar during agent operations.
247
+ Consultation is always enabled. Use `/consult active` or `/consult blocking` to switch between modes. Questions appear in a dedicated panel below the status bar during agent operations.
246
248
 
247
249
  ### Vector Memory (Optional)
248
250
 
@@ -258,18 +260,18 @@ ollama pull nomic-embed-text
258
260
 
259
261
  ### Multi-Agent Orchestration
260
262
 
261
- OS Agent features an intelligent orchestration system that automatically:
263
+ osagent features an intelligent orchestration system that automatically:
262
264
 
263
265
  - **Detects skills** in your prompts (debugging, testing, refactoring, etc.)
264
266
  - **Selects the best agent** for each task based on capabilities
265
267
  - **Dispatches execution** to specialized subagents
266
268
  - **Tracks progress** with real-time status updates
267
269
 
268
- The orchestrator runs transparently - just describe what you want and OS Agent handles the rest.
270
+ The orchestrator runs transparently - just describe what you want and osagent handles the rest.
269
271
 
270
272
  ### Episodic Memory
271
273
 
272
- OS Agent learns from your sessions:
274
+ osagent learns from your sessions:
273
275
 
274
276
  - **Records episodes** of your interactions automatically
275
277
  - **Tracks actions** including tools used and files modified
@@ -280,7 +282,7 @@ Episodes are stored locally in `~/.osagent/episodes/`.
280
282
 
281
283
  ### Configuration
282
284
 
283
- OS Agent stores its configuration in `~/.osagent/` (created automatically on first run):
285
+ osagent stores its configuration in `~/.osagent/` (created automatically on first run):
284
286
 
285
287
  ```
286
288
  ~/.osagent/
@@ -306,7 +308,7 @@ model: qwen2.5-coder:32b
306
308
 
307
309
  ### Project Memory
308
310
 
309
- Create an `OSAGENT.md` file in your project root to give OS Agent context:
311
+ Create an `OSAGENT.md` file in your project root to give osagent context:
310
312
 
311
313
  ```bash
312
314
  osagent /init
@@ -355,7 +357,7 @@ npm run lint
355
357
 
356
358
  ## Architecture
357
359
 
358
- OS Agent is a monorepo with the following packages:
360
+ osagent is a monorepo with the following packages:
359
361
 
360
362
  ```
361
363
  packages/
@@ -378,8 +380,6 @@ packages/
378
380
  ### During Operations
379
381
  - `Ctrl+O` - Expand/collapse output
380
382
  - `Ctrl+Y` - Toggle todo list visibility
381
- - `Ctrl+E` - Toggle agent detail level
382
- - `Ctrl+F` - Focus embedded shell
383
383
 
384
384
  ### Text Editing
385
385
  - `Ctrl+L` - Clear screen
@@ -391,135 +391,10 @@ packages/
391
391
 
392
392
  ## Documentation
393
393
 
394
- For detailed architecture documentation, see [SYSTEM_ARCHITECTURE.md](SYSTEM_ARCHITECTURE.md). This includes:
395
- - Complete request flow diagrams
396
- - Agent system and tier structure
397
- - Skill detection and auto-dispatch
398
- - Tool system and execution flow
399
- - Memory systems (episodic + vector)
400
- - Context provider hierarchy
401
- - Integration points and key files
402
-
403
- ## Recent Updates
404
-
405
- ### v0.2.6 - Smart Agent Selection
406
- - **Intelligent Orchestration**: Generic "build X" requests now use Master Orchestrator
407
- - **Confidence Thresholds**: Specialists only selected when confidence > 0.6
408
- - **New Project Detection**: Automatically routes new project requests to Orchestrator
409
- - **Tech Keyword Detection**: Only uses specialists when specific tech is mentioned
410
-
411
- ### v0.2.5 - Comprehensive Orchestrator
412
- - **Expert-Level Orchestrator**: Full tool knowledge with decision framework
413
- - **Problem-Solving Framework**: Identify, analyze, plan, implement, verify phases
414
- - **Feature Building Framework**: Understand, plan, build, verify, complete phases
415
- - **Action-Oriented Prompts**: Models now explain while acting, not just talking
416
-
417
- ### v0.2.4 - Agentic Enforcement
418
- - **Critical Operating Principle**: Models must ACT, not just describe actions
419
- - **Tool Call Requirements**: Every action statement must include tool calls
420
- - **Improved System Prompts**: Clearer instructions for tool usage
421
-
422
- ### v0.2.3 - API Key Fixes
423
- - Fixed paste handling in API key input (bracketed paste mode)
424
- - Added `/provider reset` command to clear stored API keys
425
- - Removed sudo from doctor command recommendations
426
-
427
- ### v0.2.2 - Ollama Cloud Fix
428
- - Fixed Ollama Cloud API key not being stored in environment
429
- - API key now properly persists for session after entry
430
-
431
- ### v0.2.1 - Bundle Fix
432
- - Fixed version number not showing correctly in bundled CLI
433
- - Use `npm run bundle` instead of `npm run build` for releases
434
-
435
- ### v0.2.0 - Architecture & Orchestration Improvements
436
- - **Roadmap System**: New persistent project tracking system (`roadmap` tool for agents)
437
- - Track work items with priorities, dependencies, and subtasks
438
- - Stored in `.osagent/roadmap.json` - persists across sessions
439
- - Actions: view, add, update, next, summary, note
440
- - **Consultation Integration**: Enhanced orchestrator-consultation bridge
441
- - Generates clarifying questions when prompts are ambiguous
442
- - Context-aware question generation based on skill detection
443
- - Collects enhanced context for better agent selection
444
- - **Codebase Cleanup**: Removed orphaned code and redundant hooks
445
- - Deleted unused memory command hooks
446
- - Consolidated RoadmapContext into core service
447
- - Updated architecture documentation
448
- - **Documentation**: Added comprehensive SYSTEM_ARCHITECTURE.md
449
- - Complete system flow documentation
450
- - Agent tiers and selection rules
451
- - Skill detection process
452
- - Tool registration patterns
453
-
454
- ### v0.1.87 - Test Fixes & Documentation
455
- - Fixed all test failures (3170/3170 tests now passing)
456
- - Updated naming consistency across codebase
457
- - Fixed vision model detection in DashScope provider
458
- - Added gopd dependency troubleshooting documentation
459
- - Improved MCP client transport handling
460
-
461
- ### v0.1.86 - Auto Project Context
462
- - Automatic project context injection on first prompt
463
- - When no OSAGENT.md exists, AI auto-explores project structure before responding
464
- - No manual `/init` required for casual usage
465
-
466
- ### v0.1.85 - Security & Stability Fixes
467
- - Timer now only counts active work time (stops when idle)
468
- - Fixed command injection vulnerability in git co-author feature
469
- - Fixed symlink bypass in path validation
470
- - Fixed VimModeContext re-render loop
471
-
472
- ### v0.1.83 - Enhanced Doctor Command
473
- - Added enhanced installation diagnostics to `/doctor`
474
- - Shows installation method (npm-global, homebrew, native, source)
475
- - Displays binary path and invoked path
476
- - Shows auto-updates status and search/ripgrep status
477
- - Detects and warns about multiple installations
478
- - New "All systems go" summary style
479
-
480
- ### v0.1.81 - Stability & Auto-Initialization
481
- - Fixed "Maximum update depth exceeded" infinite loop (3800+ errors)
482
- - Added automatic `~/.osagent/` directory initialization on startup
483
- - Creates required directories: agents, commands, prompts, skills, episodes
484
- - Auth credentials now properly saved when switching providers
485
-
486
- ### v0.1.80 - Auth Provider Fix
487
- - Fixed auth configuration mismatch when switching providers
488
- - Ensures baseUrl and model are saved correctly to settings
489
-
490
- ### v0.1.79 - IDE Terminal Compatibility
491
- - Migrated all dialogs from custom `useKeypress` to Ink's `useInput` hook
492
- - Fixes arrow key issues in VS Code, Cursor, and other IDE terminals
493
- - Arrow keys no longer print escape sequences (`^[[A^[[B`) in dialogs
494
- - Improved compatibility with IDE terminals that don't support raw mode
495
-
496
- ### v0.1.66 - Focus Management
497
- - New `useFocusedKeypress` hook for enforced focus management
498
- - Prevents keypress conflicts between dialogs and main UI
499
- - Required `isFocused` parameter catches bugs at compile time
500
-
501
- ### v0.1.65 - Input Routing Fix
502
- - Fixed keyboard input routing issues with selectors
503
- - Arrow keys and Enter now properly isolated to focused component
504
- - No more keypress "leakage" between dialogs
505
-
506
- ### v0.1.64 - UI Improvements
507
- - Tree-view style tool display with `├─` `└─` connectors
508
- - Expandable results with `Ctrl+O`
509
- - Token counts and duration stats
510
- - Sleeker ASCII art header
511
- - Minimal init banner
512
-
513
- ### v0.1.63 - Stability Fix
514
- - Fixed infinite loop on startup (Maximum update depth exceeded)
515
- - Improved React effect dependency management
516
-
517
- ### v0.1.59 - Terminal Stability
518
- - Fixed EIO error crash on stdin
519
- - Graceful handling of TTY disconnects
520
- - Stable arrow key navigation in selectors
521
-
522
- See [KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) for detailed issue tracking.
394
+ - [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture, message flow, content generators, and tool system
395
+ - [CHANGELOG.md](CHANGELOG.md) - Full version history and release notes
396
+ - [docs/](docs/) - Detailed documentation on CLI, tools, core APIs, and features
397
+ - [docs/reference/](docs/reference/) - System architecture deep-dive, UI/UX flow, tech stack
523
398
 
524
399
  ## License
525
400