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.
- package/README.md +24 -149
- package/cli.js +915 -521
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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` -
|
|
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
|
|
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
|
-
|
|
236
|
+
osagent can ask you clarifying questions as it works to better understand your requirements:
|
|
237
237
|
|
|
238
238
|
```bash
|
|
239
|
-
/consult
|
|
239
|
+
/consult active # Active mode - questions shown while agent works
|
|
240
240
|
/consult blocking # Blocking mode - high-priority questions pause the agent
|
|
241
|
-
/consult
|
|
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
|
-
|
|
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
|
|
270
|
+
The orchestrator runs transparently - just describe what you want and osagent handles the rest.
|
|
269
271
|
|
|
270
272
|
### Episodic Memory
|
|
271
273
|
|
|
272
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
395
|
-
-
|
|
396
|
-
-
|
|
397
|
-
-
|
|
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
|
|