npm - winter-super-cli - Versions diffs - 2026.6.19 → 2026.6.20 - Mend

winter-super-cli 2026.6.19 → 2026.6.20

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 (6) hide show

package/README.md +144 -641
package/package.json +1 -1
package/src/ai/provider-adapters.js +317 -0
package/src/ai/providers.js +104 -122
package/src/cli/repl.js +3484 -3484
package/src/tools/executor.js +37 -36

package/README.md CHANGED Viewed

@@ -1,719 +1,222 @@
-# Winter -- Advanced AI Coding Assistant
+# Winter
-> **Winter** is a powerful, AI-driven CLI coding assistant designed to supercharge your development workflow directly from the terminal. Inspired by Claude Code and Codex CLI, Winter brings a beautiful Cyberpunk aesthetic, smart session management, autonomous agent capabilities, and 25+ AI tools to your local environment.
+> **Winter** is an AI-powered CLI for coding, debugging, refactoring, and multi-provider model orchestration.
 >
-> *Winter là một trợ lý lập trình CLI mạnh mẽ được điều khiển bởi AI, giúp tăng tốc quy trình phát triển trực tiếp từ terminal. Lấy cảm hứng từ Claude Code và Codex CLI, Winter mang đến giao diện Cyberpunk đẹp mắt, quản lý phiên làm việc thông minh, khả năng agent tự trị, và hơn 25 công cụ AI.*
----
-## Key Features
-| Feature | Description |
-|---------|-------------|
-| **26 AI Tools** | Read, Write, Edit, Bash, Glob, Grep, Notebook, Todo, Scheduler, Agent, MCP & more |
-| **Multi-Provider** | Anthropic, OpenAI, Ollama, Groq -- with **smart context routing** |
-| **Context Router** | Auto-selects best provider per task (Claude for code, OpenAI for docs, Groq for speed, Ollama for privacy) |
-| **Session Management** | Isolated sessions with persistent memory, plans, and context |
-| **MCP Support** | Model Context Protocol -- connect VS Code, GitHub, databases & more |
-| **Permission System** | Granular allowlist for tools, commands, and MCP servers |
-| **Secret Management** | Auto-migrate API keys to `secrets.env` -- no keys in config files |
-| **Refactoring** | AI-assisted refactors with test-backed verification and minimal behavior drift |
-| **Skills System** | Strong skill workflows with `skill-creator`, hot-reloadable custom skills, and bundled guidance |
-| **TypeScript Definitions** | Typed surface for core CLI helpers and skill metadata |
-| **Plugin System** | Load local Claude Code / Codex plugins |
-| **Design Integration** | Browse & apply design systems from awesome-design-md |
-| **Auto-Healing** | TDD-style loop -- AI runs tests & fixes errors automatically |
-| **Git Auto-Pilot** | Auto commit messages + AI code reviews |
-| **Real-time Streaming** | SSE streaming for instant response display |
-| **Task Scheduler** | Schedule wakeup calls for delayed operations |
-| **Clipboard Integration** | `/paste` command reads clipboard directly |
-| **Image Support** | Analyze images & screenshots via `/image` |
-| **Cross-Platform** | Windows, macOS, Linux -- full shell support |
-| **Codebase Index** | Fast semantic search with optional CodeGraph integration |
-| **Embedded Context Corpus** | Built-in knowledge base from 7,900+ embedded documents |
----
-## Project Stats
-| Metric | Value |
-|--------|-------|
-| **Total Source Files** | 125 |
-| **Source Lines of Code** | 26,080 |
-| **Source Code Size** | ~1 MB |
-| **Tools** | **26** |
-| **Slash Commands** | 50+ |
-| **AI Providers** | 4 (Anthropic, OpenAI, Ollama, Groq) |
-| **Bundled Resources** | 8,578 files (design guides, agent docs, karpathy tools, page agents) |
-| **Node.js** | >= 18.0.0 |
----
-## Installation
-### Global install via npm
+> Built for local development workflows, Winter combines a fast terminal UX, session memory, slash commands, tool execution, provider routing, and a growing set of automation features.
-```bash
-npm install -g winter-super-cli@latest
-```
+## Highlights
-### Run directly (no install)
+- **Multi-provider AI** with support for OpenAI-compatible, Anthropic, and Gemini-style APIs
+- **Universal provider abstraction** for custom gateways and named presets like Qwen, Kimi, MiniMax, DeepSeek, OpenRouter, Groq, Ollama, Mistral, Fireworks, SiliconFlow, Zhipu, Baichuan, and more
+- **Custom provider support** with `apiFormat: openai | anthropic | gemini`
+- **Streaming + tool use** through a normalized provider adapter layer
+- **Session memory, plans, tasks, and history** for long-running coding work
+- **Rich slash-command workflow** for provider switching, search, debugging, design systems, skills, MCP, and automation
+- **Local resource packs** for design systems, agent docs, Karpathy tools, Claude/Codex references, and ECC knowledge browsing
-```bash
-git clone https://github.com/anhtu1707/winter.git
-cd winter
-node bin/winter.js
-```
+## Quick Start
-### Verify installation
+### Install
 ```bash
-winter --version
-winter --help
+npm install -g winter-super-cli
 ```
----
-## Quick Start
+### Run
 ```bash
-# Start REPL in current directory
 winter
-# Start with a specific session
-winter --session mysession
-# Run one-shot command
-winter chat "refactor this function to use async/await"
-# Call all providers
-winter call "Analyze this code architecture"
-# Non-interactive mode
-winter chat "explain this" --no-interactive
 ```
----
-## AI Providers
-Winter supports **4 AI providers** with automatic context routing:
-| Provider | Config Key | Default Model | Best For |
-|----------|------------|---------------|----------|
-| **Anthropic** | `anthropic` | `claude-sonnet-4-20250514` | Code review, refactoring, debugging |
-| **OpenAI** | `openai` | `gpt-4-turbo` | Documentation, explanations |
-| **Ollama** (local) | `ollama` | `llama3` | Privacy, offline use |
-| **Groq** | `groq` | `llama-3.1-70b-versatile` | Speed, quick tasks |
-### Provider commands
+### Verify
 ```bash
-# List all providers
-winter providers
-# Switch provider
-winter provider ollama
-# Set model for current provider
-winter model gpt-4
-# Set model for specific provider
-winter model ollama llama3.1
-# List all models
-winter models
+winter --help
+winter --version
 ```
-### Smart Context Routing
-Winter automatically selects the best provider based on your task:
-```javascript
-// Code tasks -> Claude (or first available)
-"Please review this refactor and fix the bug"
+## What Winter Does
-// Documentation tasks -> OpenAI
-"Write a commit message for these changes"
+Winter is designed to help you move through the full coding loop:
-// Speed tasks -> Groq
-"Quickly list all files with TODO comments"
+1. inspect the codebase
+2. plan the change
+3. edit surgically
+4. verify with tests or syntax checks
+5. repeat until the result is solid
-// Privacy tasks -> Ollama (local)
-"Analyze this sensitive code locally"
+It is especially useful for:
-// Explicit override
-"@claude fix this security vulnerability"
-```
+- debugging runtime issues
+- refactoring existing code
+- generating and applying patches
+- switching between AI providers
+- inspecting large local contexts
+- working with tools, sessions, and background tasks
----
+## Provider Support
-## Configuration
+Winter supports a flexible provider model:
-Configuration is stored in `~/.winter/winter.json`.
+- **OpenAI-compatible APIs**
+- **Anthropic native API**
+- **Google Gemini native API**
+- **Custom local or remote gateways**
+- **Preset providers** with automatic base URL / model defaults
-### Default configuration
+### Example: custom OpenAI-compatible provider
 ```json
 {
-  "defaultProvider": "ollama",
-  "anthropic": {
-    "apiKeyEnv": "ANTHROPIC_API_KEY",
-    "model": "claude-sonnet-4-20250514"
-  },
-  "openai": {
-    "apiKeyEnv": "OPENAI_API_KEY",
-    "model": "gpt-4-turbo"
-  },
-  "ollama": {
-    "baseURL": "http://localhost:11434",
-    "model": "llama3"
-  },
-  "groq": {
-    "apiKeyEnv": "GROQ_API_KEY",
-    "model": "llama-3.1-70b-versatile"
-  },
-  "permissions": {
-    "promptByDefault": true,
-    "allowlist": {
-      "tools": ["Read", "Glob", "Grep", "WebFetch", "WebSearch", "Parallel"],
-      "commands": [],
-      "mcpServers": []
-    }
-  },
-  "mcp": {
-    "servers": []
-  },
-  "sandbox": {
-    "enabled": true,
-    "allowedCommands": ["git", "npm", "node", "python", "code"]
-  },
-  "session": {
-    "autoSave": true,
-    "maxHistory": 500
+  "custom": {
+    "baseURL": "http://localhost:4000/v1",
+    "apiKey": "your-key",
+    "model": "gpt-4o-mini"
   }
 }
 ```
-### Secret Management
-API keys are **never stored in winter.json**. They are auto-migrated to `~/.winter/secrets.env`:
-```bash
-# Check config
-winter config
-# Migrate existing inline secrets to secrets.env
-winter config migrate-secrets
+### Example: custom Anthropic provider
-# Backup config
-winter config backup
-# Restore from backup
-winter config restore <backup-path>
+```json
+{
+  "custom": {
+    "apiFormat": "anthropic",
+    "apiKey": "your-anthropic-key",
+    "model": "claude-3-5-sonnet-latest"
+  }
+}
 ```
-Environment variables set in `secrets.env` are auto-loaded by `ConfigLoader`:
+### Example: custom Gemini provider
+```json
+{
+  "custom": {
+    "apiFormat": "gemini",
+    "apiKey": "your-gemini-key",
+    "model": "gemini-1.5-pro"
+  }
+}
 ```
-# ~/.winter/secrets.env
-ANTHROPIC_API_KEY=sk-ant-...
-OPENAI_API_KEY=sk-proj-...
-GROQ_API_KEY=gsk-...
-```
----
-## 26 AI Tools
-Winter provides **26 tools** -- fully compatible with Claude Code's tool interface + extras:
-| # | Tool | Description |
-|----|------|-------------|
-| 1 | **Read** | Read files with line numbers |
-| 2 | **Write** | Create new files |
-| 3 | **Edit** | Surgical string replacement (search & replace) |
-| 4 | **Bash** | Execute shell commands |
-| 5 | **Glob** | Find files by pattern |
-| 6 | **Grep** | Advanced regex search (context lines, case-insensitive, invert, multiline, max results) |
-| 7 | **LSP** | Language Server Protocol integration |
-| 8 | **TaskCreate** | Create background tasks |
-| 9 | **TaskUpdate** | Update task status |
-| 10 | **TaskList** | List all tasks |
-| 11 | **MCP** | Model Context Protocol tool calls |
-| 12 | **Parallel** | Execute multiple tools in parallel |
-| 13 | **NotebookRead** | Read Jupyter notebook cells |
-| 14 | **NotebookEdit** | Edit Jupyter notebook cells |
-| 15 | **TodoWrite** | Write todo items to a file |
-| 16 | **TodoList** | List todo items |
-| 17 | **ScheduleWakeup** | Schedule delayed operations |
-| 18 | **AskUserQuestion** | Ask the user a question (text/select/multiselect) |
-| 19 | **Agent** | Deploy a sub-agent for complex tasks |
-| 20 | **InsertText** | Insert text at specific positions (line, after, before, beginning, end) |
-| 21 | **StrReplaceAll** | Batch string replace across files |
-| 22 | **BrowserDebug** | Browser automation & debugging |
-| 23 | **WebFetch** | Fetch web page content |
-| 24 | **WebSearch** | Search the web |
-| 25 | **WebArchive** | Archive & retrieve web pages (Wayback Machine + local cache) |
-| 26 | **HtmlEffectiveness** | Compile hybrid Markdown + YAML components into self-contained HTML |
-### Advanced Grep Features
-Grep tool supports:
-- **Regex patterns** -- actual `RegExp`, not substring matching
-- **Case insensitive** -- `case_insensitive: true`
-- **Invert match** -- `invert_match: true`
-- **Fixed string** -- `fixed_string: true` (escape regex chars)
-- **Context lines** -- `context_lines`, `before_lines`, `after_lines`
-- **Max results** -- configurable limit (default 50, max 500)
-- **Line numbers** -- toggle `line_numbers: true/false`
-- **Multiline** -- `multiline: true` search across lines
-- **Output modes** -- `content`, `files_with_matches`, `count`
----
-## Bundled Resources
-Winter ships with **7 integrated resource corpora** (8,578 files total):
-| Resource | Files | Size | Description |
-|----------|-------|------|-------------|
-| **codex** | 206 | 116 MB | Codex CLI documentation & examples |
-| **page-agent** | 239 | - | Alibaba GUI agent framework |
-| **awesome-design-md** | 142 | 14 MB | 71 design systems (Airbnb, Apple, BMW, Claude, Coinbase, Cursor, Figma...) |
-| **claude** | 795 | 3 MB | Claude Code prompts & patterns |
-| **agents.md** | 62 | 2 MB | Agent documentation & examples |
-| **karpathy-tools** | 2 | 1.3 MB | Karpathy's coding principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) |
-| **ecc** | 7,932 | - | Embedded Context Corpus - searchable knowledge base |
-### Resource Commands
-```bash
-# Browse karpathy-tools
-/karpathy
-# Browse codex resources
-/codex
-# Browse claude resources
-/claude
+### Example: preset provider
-# Browse agents.md
-/agents
-# Show all bundled resources
-/resources
-# Search ECC (Embedded Context Corpus)
-winter ecc search "error handling"
-winter ecc browse skills/error-handling
+```json
+{
+  "qwen": {
+    "apiKey": "your-dashscope-key"
+  },
+  "kimi": {
+    "apiKey": "your-moonshot-key"
+  },
+  "minimax": {
+    "apiKey": "your-minimax-key"
+  }
+}
 ```
----
-## Slash Commands
-### Project & Session
-| Command | Description |
-|---------|-------------|
-| `/project` | Show/set current project |
-| `/pwd` | Show current directory |
-| `/cd <path>` | Change directory |
-| `/session` | Show current session ID |
-| `/sessions` | List all sessions |
-| `/clear` | Clear screen |
-### Memory & Plans
-| Command | Description |
-|---------|-------------|
-| `/remember <text>` | Store in memory |
-| `/memories` | Show stored memories |
-| `/forget [pattern]` | Clear memories |
-| `/compress` | Compress conversation context |
-| `/plan` | Create/view plans |
-| `/plans` | List active plans |
-| `/task <desc>` | Create task |
-| `/tasks` | List tasks |
-### Git & Automation
-| Command | Description |
-|---------|-------------|
-| `/commit` | Auto-generate commit message & commit |
-| `/review` | AI code review on current diff |
-| `/diff` | Preview git diff |
-| `/watch <cmd>` | Watch files & run command |
-| `/stats` | Tool usage statistics |
-| `/replay [n]` | Replay tool events |
-| `/swe <task>` | Run SWE-agent workflow |
-| `/auto <task>` | Auto-healing mode (TDD loop) |
-| `/autopilot <task>` | Autonomous analyze/fix/verify workflow |
-| `/autopilot <task> --max-loops <n> --verify "cmd1;cmd2"` | Configure retry loops and explicit verification commands |
-### Tool Shortcuts
-| Command | Description |
-|---------|-------------|
-| `/read <file>` | Quick file read |
-| `/write <file>` | Quick file write (via editor) |
-| `/edit <file>` | Quick file edit |
-| `/bash <cmd>` | Quick command execution |
-| `/glob <pattern>` | Quick file search |
-| `/grep <pattern>` | Quick text search |
-| `/image <file>` | Analyze image/screenshot |
-| `/paste` | Paste clipboard content |
-### Resources & Design
-| Command | Description |
-|---------|-------------|
-| `/codex` | Browse ~/.codex resources |
-| `/claude` | Browse ~/.claude resources |
-| `/karpathy` | Browse karpathy-tools |
-| `/agents` | Read ~/agents.md |
-| `/resources` | Show bundled resources |
-| `/htmlfx` | Manage html-effectiveness integration (install/list/compile) |
-| `/design search <brand>` | Search design systems |
-| `/design add <brand>` | Add design system |
-| `/design list` | List design systems |
-| `/design preview <brand>` | Preview design system |
-| `/ecc search <query>` | Search Embedded Context Corpus |
-| `/ecc browse <path>` | Browse ECC section |
-| `/skill list` | List skills |
-| `/skill enable <name>` | Enable a skill |
-| `/skill create <name>` | Create a custom skill |
-| `/plugin list` | List plugins |
-| `/plugin install <url>` | Install a plugin |
-### Provider & Config
-| Command | Description |
-|---------|-------------|
-| `/provider [name]` | Show/switch provider |
-| `/providers` | List all providers |
-| `/model [id]` | Show/set model |
-| `/models` | List models |
-| `/config` | Show configuration |
-| `/mcp list` | List MCP servers |
-| `/mcp add <name> <cmd>` | Add MCP server |
-| `/mcp remove <name>` | Remove MCP server |
-| `/permissions list` | List permission allowlist |
-| `/permissions allow <kind> <value>` | Allow tool/command/mcp |
-### Help & Exit
-| Command | Description |
-|---------|-------------|
-| `/help` or `/?` | Show help |
-| `/exit` or `/quit` | Exit Winter |
----
-## MCP Integration
-Winter supports the **Model Context Protocol** for connecting to external tools and services.
-### MCP CLI Commands
+## Key Commands
-```bash
-# List configured MCP servers
-winter mcp list
-# Add an MCP server
-winter mcp add my-server node ./path/to/server.js
-# Remove an MCP server
-winter mcp remove my-server
-# Allow an MCP server (permissions)
-winter mcp allow my-server
-```
-### MCP Permission Management
+### Provider commands
 ```bash
-# List all permissions
-winter permissions list
-# Allow a tool
-winter permissions allow tool Bash
-# Allow a command
-winter permissions allow command git
-# Allow an MCP server
-winter permissions allow mcp my-server
-# Toggle prompt-before-execute mode
-winter permissions prompt off
-```
-### Dynamic Tool Routing
-Tools with the `mcp__` prefix are automatically routed to the appropriate MCP server:
-```
-mcp__vscode__openFile  ->  VS Code extension server
-mcp__github__createPR ->  GitHub integration server
-mcp__db__query        ->  Database server
+winter providers
+winter provider <name>
+winter model <model-id>
+winter models
+winter config
 ```
----
-## Session Management
-Winter provides persistent session management with memory and context.
+### Project workflow
 ```bash
-# CLI commands
-winter session new       # Create new session
-winter session save      # Save current session
-winter session list      # List all sessions
-# In REPL
-/session                 # Show session ID
-/sessions                # List all sessions
-/remember <text>         # Store in memory
-/memories                # Show memories
-/forget [pattern]        # Clear memory
-/compress                # Compress context
+winter
+winter /context "analyze this refactor"
+winter /doctor full
+winter /scorecard
 ```
-### Three-Tier Memory System
-| Level | Scope | Purpose |
-|-------|-------|---------|
-| **Working Memory** | Current session | Task context, conversation history |
-| **Project Memory** | Project-wide | Project-specific learnings & rules |
-| **Long-term Memory** | Cross-project | Reusable patterns & knowledge |
----
+### Useful slash commands
-## Skills System
+- `/providers` — list configured providers
+- `/provider` — switch provider
+- `/model` — set active model
+- `/context` — inspect model context
+- `/doctor` — diagnose provider/model/tool calls
+- `/design` — browse and apply design systems
+- `/skill` — manage skills
+- `/mcp` — manage MCP servers
+- `/auto` — run test/fix loop
+- `/ensemble` — run providers in parallel
+- `/vote` — compare model outputs
-Winter supports hot-reloadable skills for specialized tasks.
-### Built-in Skills
-| Skill | Description |
-|-------|-------------|
-| `coding` | Code analysis, generation, review |
-| `design` | Design system integration |
-| `debug` | Debugging assistance |
-| `refactor` | Code refactoring |
-| `test` | Test generation |
-| `skill-creator` | Create & modify custom skills |
+## Configuration
-### Custom Skills
+Winter reads config from the user profile directory. Typical settings include:
-```bash
-# Create a new skill
-winter skill create my-skill
-# -> creates ~/.winter/skills/my-skill.md
+- default provider
+- provider entries
+- permissions
+- session behavior
+- MCP servers
+- sandbox / allowlist options
-# List all skills
-winter skill list
+### Minimal example
-# Enable a skill
-/skill enable my-skill
+```json
+{
+  "defaultProvider": "custom",
+  "custom": {
+    "apiFormat": "openai",
+    "baseURL": "http://localhost:4000/v1",
+    "apiKey": "your-key",
+    "model": "gpt-4o-mini"
+  }
+}
 ```
----
+## Documentation
-## Plugin System
+- [Provider abstraction guide](docs/provider-abstraction.md)
+- [Project architecture](docs/architecture.md)
+- [Slash commands](src/cli/slash-commands.js)
-Load plugins from Claude Code and Codex CLI:
+## Development
 ```bash
-winter plugin list                     # List plugins
-winter plugin install <url>            # Install plugin
-winter plugin remove <name>            # Remove plugin
+npm install
+npm test
 ```
----
-## Embedded Context Corpus (ECC)
-Winter includes a **searchable knowledge base** with 7,932 embedded documents covering:
-- Error handling patterns
-- Testing strategies
-- Security best practices
-- Performance optimization
-- And more...
-### ECC Commands
+### Useful scripts
 ```bash
-# Search the corpus
-winter ecc search "error handling"
-winter ecc search "async await best practices"
-# Browse sections
-winter ecc browse skills
-winter ecc browse skills/error-handling
-winter ecc browse testing/patterns
-```
----
-## Architecture
+npm run test
+npm run prepublish:gate
+npm run pack:audit
+npm run smoke:package
 ```
-winter/
-|- bin/
-|   - winter.js              # Entry point
-|- src/
-|   |- agent/
-|   |   - swe-agent.js       # SWE-agent integration
-|   |   - runtime.js         # Agent runtime
-|   |   - agent-definitions.js
-|   |- ai/
-|   |   - providers.js       # AI provider management + streaming
-|   |   - orchestrator.js   # AI orchestration
-|   |   - reasoning.js       # Reasoning patterns
-|   |   - small-model-amplifier.js
-|   |   - workflow-selector.js
-|   |- cache/
-|   |   - system.js         # Caching layer
-|   |   - embeddings.js     # Embedding cache
-|   |- cli/
-|   |   - commands.js       # CLI command parser (50+ commands)
-|   |   - config.js         # Config loader + secret management
-|   |   - conversation-format.js
-|   |   - markdown-format.js
-|   |   - prompt-builder.js
-|   |   - repl-commands.js
-|   |   - repl.js           # Interactive REPL loop
-|   |   - secret-env.js     # Env file loader + redaction
-|   |   - slash-commands.js
-|   |   - snowflake-logo.js # Cyberpunk UI branding
-|   |   - spinner.js
-|   |   - terminal-ui.js
-|   |   - context-loader.js # Resource loading
-|   |   - ecc.js            # Embedded Context Corpus
-|   |   - codebase-index/  # Fast semantic search
-|   |- context/
-|   |   - compress.js       # Conversation compression
-|   |   - router.js         # Smart provider routing
-|   |   - resource-loader.js
-|   |- design/
-|   |   - commands.js       # Design system commands
-|   |- mcp/
-|   |   - client.js         # MCP client
-|   |   - protocol.js       # MCP protocol implementation
-|   |- plugins/
-|   |   - manager.js        # Plugin manager
-|   |- session/
-|   |   - manager.js        # Session manager
-|   |- skills/
-|   |   - manager.js        # Skills manager
-|   - tools/
-|       - executor.js       # Tool executor (25 tools)
-|       - notebook.js       # Jupyter notebook tools
-|       - todo.js           # Todo tools
-|       - scheduler.js      # Schedule wakeup tool
-|       - interactive.js    # Ask user tool
-|       - agent.js          # Sub-agent tool
-|       - insert-text.js    # Insert text tool
-|       - str-replace-all.js # Batch replace tool
-|       - web-archive.js    # Web archive tool
-|       - permission.js     # Permission manager
-|- resources/local/
-|   |- codex/              # Codex CLI resources (206 files)
-|   |- page-agent/         # GUI automation (239 files)
-|   |- awesome-design-md/  # Design systems (142 files)
-|   |- claude/             # Claude patterns (795 files)
-|   |- agents.md/          # Agent docs (62 files)
-|   |- karpathy-tools/     # Coding principles (2 files)
-|   |- ecc/                # Embedded Context Corpus (7,932 files)
-|- README.md
-|- WINTER.md               # Project rules for AI
-|- package.json
-```
----
-## Core Philosophy
-Winter operates on **four core principles**:
-### 1. Think Before Coding
-*Nghi trước khi code*
-- State assumptions explicitly. If uncertain, ask.
-- Surface tradeoffs and alternatives -- don't pick silently.
-- If a simpler approach exists, say so. Push back when warranted.
-### 2. Simplicity First
-*Đơn giản là trên hết*
-- Minimum code that solves the problem. Nothing speculative.
-- No features beyond what was asked.
-- No abstractions for single-use code.
-- No error handling for impossible scenarios.
-### 3. Surgical Changes
-*Sửa đổi chính xác*
+## Repository Structure
-- Touch only what you must. Clean up only your own mess.
-- Don't "improve" adjacent code, comments, or formatting.
-- Don't refactor things that aren't broken.
-- Match existing style, even if you'd do it differently.
-### 4. Goal-Driven Execution
-*Thực thi theo mục tiêu*
-- Define success criteria clearly.
-- Loop until verified -- don't claim completion without tool results.
-- Verify each step with the closest command available.
-> *These principles are integrated from [Karpathy Tools](resources/local/karpathy-tools/CLAUDE.md) and applied throughout Winter's operation.*
----
-## Streaming & Real-time
-Winter supports **real-time SSE streaming** for instant response display:
-```
-User input -> REPL -> collectAssistantStream()
--> providers.streamRequest() -> streamRequestToProvider()
--> Fetch POST /chat/completions (stream: true)
--> Parse SSE data: events
--> Each chunk.content -> process.stdout.write immediately
--> Fallback to sendRequest() if stream fails
+```text
+src/
+  ai/          provider manager, adapters, prompts, reasoning
+  cli/         REPL, slash commands, session UI
+  context/     routing, resource loading, compression
+  tools/       file, shell, browser, agent, and utility tools
+resources/local/
+  design-md/   local design system corpus
+  agents.md/   agent workflow docs
+  karpathy-tools/
+  page-agent/
 ```
----
-## Cross-Platform Support
-| Platform | Shell Support | Status |
-|----------|----------------|--------|
-| **Windows** | cmd, PowerShell, Git Bash | Full support |
-| **macOS** | zsh, bash | Full support |
-| **Linux** | bash, sh, zsh | Full support |
-Winter auto-detects your platform and shell:
-- On Windows: uses `cmd` or `powershell` as appropriate
-- On macOS/Linux: uses native POSIX shell
----
 ## License
-MIT License -- see [LICENSE](LICENSE) for details.
----
+MIT
 ## Author
-**Atus** -- fb: iam.anhtu | github: [anhtu1707](https://github.com/anhtu1707)
----
-*Built with care -- Winter is the AI assistant that never sleeps.*
+**Atus** — [github.com/anhtu1707](https://github.com/anhtu1707) - **Atus** — [facebook.com/iam.anhtu](https://facebook.com/iam.anhtu)