fecode-cli 1.1.3 → 1.2.0
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 +92 -8
- package/dist/index.js +23293 -1
- package/dist/{node.browser-BsGbhAIw.js → node.browser-2EgZAKSy.js} +1 -1
- package/dist/{node.browser-B5CfqNxN.js → node.browser-B5Gur0wd.js} +1 -1
- package/dist/{node.browser-BWLpZywP.js → node.browser-BSlAsiSV.js} +1 -1
- package/dist/{node.browser-7pW7d9_e.js → node.browser-CdVAMgSg.js} +1 -1
- package/dist/{src-CxriUNOE.js → src-CSWdjU4j.js} +4836 -4522
- package/dist/{src-DBoGZaxi.js → src-DY3OmBmT.js} +6670 -4557
- package/dist/{src-B_Z8CdqT.js → src-DcYf8vsK.js} +4850 -4526
- package/dist/{src-Bhec3XmL.js → src-DkWmcv2Q.js} +6677 -4604
- package/package.json +5 -2
- package/skills/accessibility/SKILL.md +98 -98
- package/skills/css/SKILL.md +90 -90
- package/skills/frontend-debugging/SKILL.md +201 -201
- package/skills/frontend-design/SKILL.md +358 -358
- package/skills/frontend-performance/SKILL.md +89 -89
- package/skills/frontend-testing/SKILL.md +87 -87
- package/skills/nextjs/SKILL.md +75 -75
- package/skills/react/SKILL.md +213 -213
- package/skills/responsive-design/SKILL.md +190 -190
- package/skills/svelte/SKILL.md +86 -86
- package/skills/tailwind/SKILL.md +74 -74
- package/skills/ui-review/SKILL.md +245 -245
- package/skills/vue/SKILL.md +72 -72
- package/dist/App.d.ts +0 -33
- package/dist/App.js +0 -2224
- package/dist/approvalResolver.d.ts +0 -12
- package/dist/approvalResolver.js +0 -112
- package/dist/commands.d.ts +0 -11
- package/dist/commands.js +0 -33
- package/dist/error-qAR8Lv-R.js +0 -57
- package/dist/index.d.ts +0 -3
- package/dist/node.browser-C9Wg-Fje.js +0 -46
- package/dist/node.browser-CADgAblr.js +0 -46
- package/dist/node.browser-Cse19Rko.js +0 -47
- package/dist/node.browser-Cx8sZi1Z.js +0 -46
- package/dist/node.browser-DtPNhPGQ.js +0 -46
- package/dist/node.browser-DvjMZMaq.js +0 -46
- package/dist/node.browser-EewJmuUw.js +0 -46
- package/dist/node.browser-J7voHtuR.js +0 -10
- package/dist/src-4fKRO0jn.js +0 -31655
- package/dist/src-8kA-5Kbs.js +0 -31591
- package/dist/src-C8Oe06wn.js +0 -31580
- package/dist/src-D78uLcuc.js +0 -31573
- package/dist/src-EyWDnffN.js +0 -31636
- package/dist/src-dhvwrHAJ.js +0 -31590
- package/dist/ui/AppShell.d.ts +0 -14
- package/dist/ui/AppShell.js +0 -25
- package/dist/ui/ApprovalPrompt.d.ts +0 -31
- package/dist/ui/ApprovalPrompt.js +0 -55
- package/dist/ui/BlockedView.d.ts +0 -13
- package/dist/ui/BlockedView.js +0 -7
- package/dist/ui/CommandPalette.d.ts +0 -8
- package/dist/ui/CommandPalette.js +0 -18
- package/dist/ui/CurrentStepView.d.ts +0 -16
- package/dist/ui/CurrentStepView.js +0 -28
- package/dist/ui/DiagnosticsView.d.ts +0 -45
- package/dist/ui/DiagnosticsView.js +0 -23
- package/dist/ui/ExecutionTimeline.d.ts +0 -15
- package/dist/ui/ExecutionTimeline.js +0 -51
- package/dist/ui/ExecutionView.d.ts +0 -42
- package/dist/ui/ExecutionView.js +0 -20
- package/dist/ui/Header.d.ts +0 -15
- package/dist/ui/Header.js +0 -47
- package/dist/ui/HelpView.d.ts +0 -3
- package/dist/ui/HelpView.js +0 -35
- package/dist/ui/MessageBubble.d.ts +0 -9
- package/dist/ui/MessageBubble.js +0 -58
- package/dist/ui/PlanStep.d.ts +0 -16
- package/dist/ui/PlanStep.js +0 -71
- package/dist/ui/PlanView.d.ts +0 -26
- package/dist/ui/PlanView.js +0 -24
- package/dist/ui/ProgressBar.d.ts +0 -10
- package/dist/ui/ProgressBar.js +0 -14
- package/dist/ui/RecoveryView.d.ts +0 -20
- package/dist/ui/RecoveryView.js +0 -19
- package/dist/ui/ReplanView.d.ts +0 -16
- package/dist/ui/ReplanView.js +0 -21
- package/dist/ui/ResumeView.d.ts +0 -15
- package/dist/ui/ResumeView.js +0 -25
- package/dist/ui/RiskNotice.d.ts +0 -10
- package/dist/ui/RiskNotice.js +0 -21
- package/dist/ui/RunHistoryView.d.ts +0 -15
- package/dist/ui/RunHistoryView.js +0 -39
- package/dist/ui/StatusBar.d.ts +0 -16
- package/dist/ui/StatusBar.js +0 -104
- package/dist/ui/TaskInput.d.ts +0 -15
- package/dist/ui/TaskInput.js +0 -8
- package/dist/ui/ThinkingBlock.d.ts +0 -8
- package/dist/ui/ThinkingBlock.js +0 -13
- package/dist/ui/ThinkingIndicator.d.ts +0 -7
- package/dist/ui/ThinkingIndicator.js +0 -20
- package/dist/ui/TurnView.d.ts +0 -13
- package/dist/ui/TurnView.js +0 -11
- package/dist/ui/WorkspaceStatus.d.ts +0 -20
- package/dist/ui/WorkspaceStatus.js +0 -23
- package/dist/ui/index.d.ts +0 -26
- package/dist/ui/index.js +0 -26
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
|
|
13
13
|
<img src="https://img.shields.io/badge/typescript-strict%205.7+-blue.svg" alt="TypeScript Strict" />
|
|
14
14
|
<img src="https://img.shields.io/badge/tests-1470%20passed-success.svg" alt="Tests" />
|
|
15
|
-
<img src="https://img.shields.io/badge/version-1.
|
|
15
|
+
<img src="https://img.shields.io/badge/version-1.2.0-brightgreen.svg" alt="Version 1.2.0" />
|
|
16
16
|
</p>
|
|
17
17
|
|
|
18
18
|
---
|
|
@@ -166,9 +166,35 @@ npm link --workspace=apps/cli
|
|
|
166
166
|
|
|
167
167
|
## Quick Start
|
|
168
168
|
|
|
169
|
-
### 1.
|
|
169
|
+
### 1. In-App Setup (First-Run Onboarding)
|
|
170
170
|
|
|
171
|
-
|
|
171
|
+
When launching FeCode for the first time without environment variables, FeCode displays an interactive first-run setup wizard directly in your terminal:
|
|
172
|
+
|
|
173
|
+
```text
|
|
174
|
+
╭──────────────────────────────────────────╮
|
|
175
|
+
│ Welcome to FeCode │
|
|
176
|
+
│ │
|
|
177
|
+
│ Configure your AI provider │
|
|
178
|
+
│ │
|
|
179
|
+
│ Select a provider: │
|
|
180
|
+
│ │
|
|
181
|
+
│ > Google Gemini │
|
|
182
|
+
│ OpenAI │
|
|
183
|
+
│ Ollama │
|
|
184
|
+
│ OpenAI-compatible │
|
|
185
|
+
│ │
|
|
186
|
+
│ Enter to continue │
|
|
187
|
+
╰──────────────────────────────────────────╯
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
1. Select your preferred provider using `↑`/`↓` and press `Enter`.
|
|
191
|
+
2. Enter your API key (masked with `*`) and model ID.
|
|
192
|
+
3. FeCode tests authentication and model availability before saving.
|
|
193
|
+
4. Your API key is encrypted and stored in your **Operating System Credential Vault** (Windows Credential Manager, macOS Keychain, or Linux Secret Service). Plaintext keys are never written to disk.
|
|
194
|
+
|
|
195
|
+
### 2. Alternative: Environment Variable Configuration
|
|
196
|
+
|
|
197
|
+
Existing deployments, CI/CD pipelines, and terminal setups can continue exporting environment variables or using a workspace `.env` file:
|
|
172
198
|
|
|
173
199
|
```bash
|
|
174
200
|
# Option 1: Google Gemini (Recommended Default)
|
|
@@ -186,7 +212,7 @@ export FE_PROVIDER="ollama"
|
|
|
186
212
|
export FE_MODEL="qwen2.5-coder"
|
|
187
213
|
export OLLAMA_BASE_URL="http://localhost:11434/v1"
|
|
188
214
|
|
|
189
|
-
# Option 4:
|
|
215
|
+
# Option 4: NVIDIA NIM / OpenAI-Compatible (e.g. DeepSeek on NVIDIA)
|
|
190
216
|
export FE_PROVIDER="openai-compatible"
|
|
191
217
|
export FE_MODEL="deepseek-ai/deepseek-v4.1-flash"
|
|
192
218
|
export OPENAI_API_KEY="your-nvidia-api-key"
|
|
@@ -226,13 +252,29 @@ FeCode will:
|
|
|
226
252
|
|
|
227
253
|
## Configuration
|
|
228
254
|
|
|
229
|
-
|
|
255
|
+
### Resolution & Precedence Model
|
|
256
|
+
|
|
257
|
+
FeCode resolves AI provider configuration using a strict 3-tier precedence hierarchy:
|
|
230
258
|
|
|
231
259
|
```text
|
|
232
|
-
|
|
233
|
-
(
|
|
260
|
+
1. Explicit Environment Variables (.env / export) ──▶ (Highest precedence; preserves existing CI & scripts)
|
|
261
|
+
2. Active Saved Provider Profile (OS Credential Vault)──▶ (In-app /provider profiles)
|
|
262
|
+
3. First-Run Interactive Onboarding (TUI) ──▶ (Triggered when no provider is configured)
|
|
234
263
|
```
|
|
235
264
|
|
|
265
|
+
- **Environment Variable Compatibility**: Environment variables continue to work exactly as before. Existing CI pipelines and deployments will not break.
|
|
266
|
+
- **Fail-Fast Explicit Errors**: An invalid explicit environment configuration produces a clear error immediately, rather than silently switching to a saved profile.
|
|
267
|
+
- **Safe Turn Boundaries**: Profile activation takes effect cleanly at turn boundaries; providers are never mutated mid-generation or during tool execution.
|
|
268
|
+
|
|
269
|
+
### Secure OS Credential Storage
|
|
270
|
+
|
|
271
|
+
FeCode never persists API keys in plaintext files (`.env`, `config.json`, or history). Credentials are stored exclusively in native operating system vaults:
|
|
272
|
+
- **Windows**: Windows Credential Manager
|
|
273
|
+
- **macOS**: Apple Keychain
|
|
274
|
+
- **Linux**: Secret Service API (`gnome-keyring`, `KWallet`, `KeePassXC`) / Linux Kernel Keyutils
|
|
275
|
+
|
|
276
|
+
Metadata is kept in `~/.fecode/providers.json` with opaque references (`fecode:profile:<id>`). If OS secure storage is unavailable, FeCode raises an explicit error and will **never silently fall back to plaintext**.
|
|
277
|
+
|
|
236
278
|
### Environment Variables
|
|
237
279
|
|
|
238
280
|
| Variable | Description | Default |
|
|
@@ -245,7 +287,31 @@ CLI Flags ──▶ Environment Variables ──▶ Workspace .env ──
|
|
|
245
287
|
| `OPENAI_BASE_URL` | Base API endpoint for OpenAI or OpenAI-compatible services | Standard OpenAI API (`https://api.openai.com/v1`) |
|
|
246
288
|
| `OLLAMA_BASE_URL` | Base API endpoint for local Ollama daemon | `http://localhost:11434/v1` |
|
|
247
289
|
|
|
248
|
-
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## MCP Servers
|
|
293
|
+
|
|
294
|
+
FeCode can connect to external [Model Context Protocol](https://modelcontextprotocol.io) servers and expose their tools to the model alongside its built-in tools. This is file-based configuration — create a `.fecode/mcp.json` in your project (FeCode walks upward from the working directory to find it):
|
|
295
|
+
|
|
296
|
+
```json
|
|
297
|
+
{
|
|
298
|
+
"mcpServers": {
|
|
299
|
+
"filesystem": {
|
|
300
|
+
"command": "npx",
|
|
301
|
+
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allow"]
|
|
302
|
+
},
|
|
303
|
+
"remote-example": {
|
|
304
|
+
"url": "https://example.com/mcp",
|
|
305
|
+
"headers": { "Authorization": "Bearer <token>" }
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
- `command`/`args`/`env`/`cwd` configure a locally-launched stdio server; `url`/`headers` configure a remote HTTP server.
|
|
312
|
+
- Every MCP tool call requires approval by default, the same as `execute_command` — MCP servers are external processes/services, so FeCode treats their tools as untrusted by default.
|
|
313
|
+
- Run `/mcp` inside the TUI to see which configured servers connected and how many tools each exposed.
|
|
314
|
+
- Browse the [official MCP servers list](https://github.com/modelcontextprotocol/servers) for ready-made servers to try.
|
|
249
315
|
|
|
250
316
|
---
|
|
251
317
|
|
|
@@ -261,6 +327,15 @@ FeCode abstracts model providers behind a unified streaming interface in `@fecod
|
|
|
261
327
|
| **Generic OpenAI-Compatible** | `deepseek-ai/deepseek-v4.1-flash`, NVIDIA NIM, vLLM, etc. | Yes | Yes | Cloud / Self-Hosted |
|
|
262
328
|
| **Ollama** | `qwen2.5-coder`, `deepseek-coder` | Yes | Yes | **Local (100% Offline)** |
|
|
263
329
|
|
|
330
|
+
#### NVIDIA NIM Example (via Generic OpenAI-Compatible Provider)
|
|
331
|
+
|
|
332
|
+
To configure NVIDIA NIM:
|
|
333
|
+
- **Provider**: `openai-compatible`
|
|
334
|
+
- **Provider Display Name**: `NVIDIA NIM`
|
|
335
|
+
- **Base URL**: `https://integrate.api.nvidia.com/v1`
|
|
336
|
+
- **API Key**: `nvapi-your-key-here`
|
|
337
|
+
- **Model**: `deepseek-ai/deepseek-v4.1-flash`
|
|
338
|
+
|
|
264
339
|
---
|
|
265
340
|
|
|
266
341
|
## CLI & Slash Commands
|
|
@@ -284,6 +359,14 @@ Inside the active FeCode terminal session, type `/` to access built-in commands
|
|
|
284
359
|
| Slash Command | Description |
|
|
285
360
|
| :--- | :--- |
|
|
286
361
|
| `/help` | Display list of commands and keyboard shortcuts |
|
|
362
|
+
| `/provider` | Open interactive AI provider & credential manager |
|
|
363
|
+
| `/provider list` | List all saved provider profiles |
|
|
364
|
+
| `/provider add` | Add a new provider profile |
|
|
365
|
+
| `/provider edit [id]` | Edit an existing provider profile |
|
|
366
|
+
| `/provider delete <id>` | Delete a provider profile and its OS vault credential |
|
|
367
|
+
| `/provider use <id>` | Activate a provider profile |
|
|
368
|
+
| `/provider test [id]` | Test provider connection and model availability |
|
|
369
|
+
| `/provider show [id]` | Display safe profile configuration (credentials redacted) |
|
|
287
370
|
| `/status` | View active session, selected model, and project context |
|
|
288
371
|
| `/plan [runId]` | Display active task plan or inspect the plan of a previous run |
|
|
289
372
|
| `/replan` | Request plan adaptation or re-evaluation for current task |
|
|
@@ -294,6 +377,7 @@ Inside the active FeCode terminal session, type `/` to access built-in commands
|
|
|
294
377
|
| `/diagnostics` | Display complete telemetry and diagnostic trace |
|
|
295
378
|
| `/history` | View completed tasks and outputs in the current session |
|
|
296
379
|
| `/git` | Inspect Git repository status, active branch, and modified files |
|
|
380
|
+
| `/mcp` | List configured MCP servers and their connection status |
|
|
297
381
|
| `/checkpoints` | List available rollback checkpoints |
|
|
298
382
|
| `/checkpoint` | Create a new manual workspace checkpoint |
|
|
299
383
|
| `/recover` | Inspect or initiate rollback recovery |
|