ติดตั้ง FrontAgent อย่างไร?

คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP

FrontAgent ต้องใช้ API key ไหม?

ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น

FrontAgent ใช้ทรานสปอร์ตแบบใด?

FrontAgent ทำงานแบบโลคัลผ่าน stdio

เซิร์ฟเวอร์ MCP FrontAgent | PlugMCP

Generate and refactor React, TypeScript, Vite, Tailwind CSS, and modern web UI code from structured execution plans.
Run as an AI agent CLI, VS Code AI extension, desktop agent app, or stdio MCP server for Claude Desktop, Cursor, Codex, and other MCP hosts.
Combine repository-aware RAG, Filesense navigation, facts memory, and module dependency tracking to reduce path hallucinations.
Execute browser-aware validation, page inspection, shell commands, and git/gh repository workflows behind explicit safety controls.
Enforce Specification Driven Development (SDD), minimal patches, self-healing error recovery, and quality gates for production frontend teams.
Use distilled Qwen Coder planner models from Hugging Face for local or lower-cost frontend execution planning.
✅ Two-Stage Architecture - Separate planning and execution to avoid JSON parsing errors and enable dynamic code generation
✅ Phase-Based Execution - Steps grouped by phases with error recovery within each phase
✅ Self-Healing - Tool Error Feedback Loop automatically analyzes errors and generates fix steps
✅ Facts Memory - Structured facts-based context system for precise project state tracking
✅ Module Dependency Tracking - Automatic import/export parsing to detect path hallucinations
✅ Hallucination Prevention - Multi-layer hallucination detection and interception
✅ SDD Constraints - Specification Driven Development as hard constraints for agent behavior
✅ MCP Protocol - Controlled tool invocation via Model Context Protocol
✅ Minimal Changes - Patch-based code modifications with rollback support
✅ Web Awareness - Understand page structure through browser MCP
✅ Shell Integration - Terminal command execution (requires user approval)
✅ Pre-Planning Scan - Scan project structure before planning to generate accurate file paths
✅ Auto Port Detection - Automatically detect dev server ports from config files
✅ Remote Hybrid RAG - Full-repository indexing with submodule exclusion, combining BM25 keyword search and embedding-based semantic search
✅ Filesense Navigation - Budgeted current-repository navigation with generated schemas and notes
✅ LangGraph Engine (Optional) - Switchable graph-based execution engine with optional checkpoints
✅ Planner Skills Layer - Reusable planning skills for task decomposition and phase injection
✅ Distilled Planner Assets - Repository-native training, evaluation, and release assets for the Hugging Face Planner model collection
✅ Skill Lab - Benchmark, improve, and promote content skills with local eval suites
✅ VS Code Sidebar - Marketplace extension with task runs, SDD helpers, secure settings, and run logs
✅ OSS Harness - Local contract, quality, GitNexus, and workflow gates for maintainer-friendly changes
✅ Repository Management Phase - Auto git/gh workflow after acceptance (commit, push, PR)
✅ Cross-Session Memory - Four-phase memory system (preload, runtime recall, post-task persistence, structured storage) that persists project facts, error resolutions, and dependency state across runs

# 1. Install globally via npm
npm install -g frontagent
# or using pnpm
pnpm add -g frontagent
# or using yarn
yarn global add frontagent

# 2. Configure LLM (supports OpenAI and Anthropic)
# OpenAI config
export PROVIDER="openai"
export BASE_URL="https://api.openai.com/v1"
export MODEL="gpt-4"
export API_KEY="sk-..."

# Or Anthropic config
export PROVIDER="anthropic"
export BASE_URL="https://api.anthropic.com"
export MODEL="claude-sonnet-4-20250514"
export API_KEY="sk-ant-..."

# 3. Navigate to your project directory and initialize SDD
cd your-project
fa init

# 4. Let AI help you complete tasks
fa run "Create a user login page"
fa run "Optimize homepage loading performance"
fa run "Add dark mode support"
# Use LangGraph engine + checkpoint (optional)
fa run "Add route guards and open a PR" --engine langgraph --langgraph-checkpoint

# Use the installed CLI
fa mcp serve

# Or run from a source checkout after pnpm build
node /absolute/path/to/FrontAgent-app/apps/cli/dist/index.js \
  mcp serve

fa mcp serve --project-root /absolute/path/to/your-project

fa mcp serve \
  --engine native \
  --security-mode balanced \
  --rag-repo https://github.com/ceilf6/Lab.git \
  --rag-branch main \
  --filesense-enabled true \
  --log-file .frontagent/runs/mcp-server.log

{
  "mcpServers": {
    "frontagent": {
      "command": "fa",
      "args": ["mcp", "serve"]
    }
  }
}

which node
which fa

{
  "mcpServers": {
    "frontagent": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/bin/fa", "mcp", "serve"]
    }
  }
}

{
  "mcpServers": {
    "frontagent": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "/absolute/path/to/FrontAgent-app/apps/cli/dist/index.js",
        "mcp",
        "serve"
      ]
    }
  }
}

{
  "mcpServers": {
    "frontagent": {
      "command": "fa",
      "args": ["mcp", "serve"],
      "env": {
        "PROVIDER": "openai",
        "BASE_URL": "https://api.openai.com/v1",
        "MODEL": "gpt-4",
        "API_KEY": "sk-..."
      }
    }
  }
}

{
  "success": true,
  "taskId": "task_...",
  "output": "...",
  "error": null,
  "duration": 1234,
  "runLogPath": "/absolute/path/.frontagent/runs/...",
  "executedStepsSummary": [],
  "securityDecisions": []
}

export PROVIDER="openai"
export BASE_URL="https://api.openai.com/v1"
export MODEL="gpt-4"
export API_KEY="sk-..."

fa run "Explain React setState behavior" \
  --provider openai \
  --base-url https://yunwu.ai/v1 \
  --api-key YOUR_TOKEN \
  --rag-repo https://github.com/ceilf6/Lab.git \
  --rag-branch main \
  --rag-keyword-candidates 40 \
  --rag-semantic-candidates 40 \
  --rag-keyword-weight 0.45 \
  --rag-semantic-weight 0.55

# When provider=openai, RAG embeddings inherit the same base-url/api-key by default.
# Override them only if your embedding endpoint is different.
fa run "Explain React setState behavior" \
  --provider openai \
  --base-url https://yunwu.ai/v1 \
  --api-key YOUR_TOKEN \
  --rag-embedding-model text-embedding-3-small \
  --rag-embedding-batch-size 32 \
  --rag-embedding-timeout-ms 30000

# Use Weaviate as the semantic vector store (BM25 stays local)
fa run "Explain React setState behavior" \
  --provider openai \
  --base-url https://yunwu.ai/v1 \
  --api-key YOUR_TOKEN \
  --rag-embedding-model text-embedding-3-small \
  --rag-vector-store-provider weaviate \
  --rag-weaviate-url http://127.0.0.1:8080 \
  --rag-weaviate-collection-prefix FrontAgentRagChunk \
  --rag-weaviate-batch-size 64 \
  --rag-weaviate-timeout-ms 30000

# Use OpenViking Wiki as the primary knowledge provider, with Git RAG fallback
fa run "Where is FrontAgent RAG implemented?" \
  --rag-source composite \
  --open-viking-endpoint https://openviking.example.com/query \
  --open-viking-corpus wiki \
  --open-viking-namespace docs/openviking \
  --open-viking-l1-entry docs/openviking/frontagent-l1.md

# Require OpenViking only and disable Git fallback
fa run "Where is FrontAgent RAG implemented?" \
  --rag-source openviking \
  --open-viking-endpoint https://openviking.example.com/query \
  --disable-open-viking-fallback

# Disable LLM query rewrite before retrieval
fa run "How to build a custom selector" \
  --disable-rag-query-rewrite

# Cross-encoder reranking is enabled by default after BM25 + embedding candidate retrieval
fa run "Explain React setState behavior" \
  --provider openai \
  --base-url https://yunwu.ai/v1 \
  --api-key YOUR_TOKEN \
  --rag-embedding-model text-embedding-3-small \
  --rag-reranker-model jina-reranker-v2-base-multilingual \
  --rag-reranker-base-url https://your-reranker-endpoint/v1 \
  --rag-reranker-timeout-ms 30000

# Disable reranking for a run
fa run "Explain React setState behavior" \
  --disable-rag-reranker

# Disable semantic retrieval and use BM25 only
fa run "Explain React setState behavior" \
  --disable-rag-semantic

# Disable remote RAG for a run
fa run "Create a page" --disable-rag

# Force a remote git sync before this query; by default FrontAgent reuses the local cache
fa run "Explain React setState behavior" --rag-sync-on-query

# List visible content skills
fa skill list

# Scaffold a new content skill
fa skill scaffold pricing-audit

# Generate starter trigger evals for a skill
fa skill init-evals frontend-design

# Generate starter behavior evals (binary checks for output quality)
fa skill init-behavior-evals frontend-design

# Benchmark current trigger behavior
fa skill benchmark frontend-design

# Benchmark trigger + behavior together
fa skill benchmark frontend-design --behavior

# Generate a candidate revision and compare it against baseline
fa skill improve frontend-design

# Improve with both trigger and behavior eval suites
fa skill improve frontend-design --behavior

# Promote a candidate after review
fa skill promote frontend-design 20260331T120000Z

export FRONTAGENT_RAG_SOURCE="composite" # git | openviking | composite
export FRONTAGENT_OPENVIKING_ENDPOINT="https://openviking.example.com/query"
export FRONTAGENT_OPENVIKING_API_KEY=""
export FRONTAGENT_OPENVIKING_CORPUS="wiki"
export FRONTAGENT_OPENVIKING_NAMESPACE="docs/openviking"
export FRONTAGENT_OPENVIKING_L1_ENTRY="docs/openviking/frontagent-l1.md"
export FRONTAGENT_OPENVIKING_TIMEOUT_MS="30000"
export FRONTAGENT_RAG_REPO="https://github.com/ceilf6/Lab.git"
export FRONTAGENT_RAG_BRANCH="main"
export FRONTAGENT_RAG_SYNC_ON_QUERY="false"
export FRONTAGENT_RAG_MAX_RESULTS="5"
export FRONTAGENT_RAG_KEYWORD_CANDIDATES="40"
export FRONTAGENT_RAG_SEMANTIC_CANDIDATES="40"
export FRONTAGENT_RAG_KEYWORD_WEIGHT="0.45"
export FRONTAGENT_RAG_SEMANTIC_WEIGHT="0.55"
export FRONTAGENT_RAG_QUERY_REWRITE_MAX_TOKENS="160"
export FRONTAGENT_RAG_QUERY_REWRITE_TEMPERATURE="0.1"
export FRONTAGENT_RAG_RERANKER_MODEL="jina-reranker-v2-base-multilingual"
export FRONTAGENT_RAG_RERANKER_BASE_URL="https://your-reranker-endpoint/v1"
export FRONTAGENT_RAG_RERANKER_API_KEY="sk-..."
export FRONTAGENT_RAG_RERANKER_CANDIDATE_COUNT="20"
export FRONTAGENT_RAG_RERANKER_MAX_DOCUMENT_CHARS="1800"
export FRONTAGENT_RAG_RERANKER_TIMEOUT_MS="30000"
export FRONTAGENT_RAG_EMBEDDING_MODEL="text-embedding-3-small"
export FRONTAGENT_RAG_EMBEDDING_BASE_URL="https://api.openai.com/v1"
export FRONTAGENT_RAG_EMBEDDING_API_KEY="sk-..."
export FRONTAGENT_RAG_EMBEDDING_DIMENSIONS=""
export FRONTAGENT_RAG_EMBEDDING_BATCH_SIZE="32"
export FRONTAGENT_RAG_EMBEDDING_TIMEOUT_MS="30000"
export FRONTAGENT_RAG_VECTOR_STORE_PROVIDER="weaviate"
export FRONTAGENT_RAG_WEAVIATE_URL="http://127.0.0.1:8080"
export FRONTAGENT_RAG_WEAVIATE_API_KEY=""
export FRONTAGENT_RAG_WEAVIATE_COLLECTION_PREFIX="FrontAgentRagChunk"
export FRONTAGENT_RAG_WEAVIATE_BATCH_SIZE="64"
export FRONTAGENT_RAG_WEAVIATE_TIMEOUT_MS="30000"

# Filesense lightweight repository navigation
export FRONTAGENT_FILESENSE_ENABLED="true"
export FRONTAGENT_FILESENSE_OUTPUT="summary"       # summary | candidates | verbose
export FRONTAGENT_FILESENSE_WRITE_MODE="cache"     # cache | workspace | none
                                                   # Currently a no-op: navigate is read-only, so `cache`
                                                   # and `none` behave identically and `workspace` is
                                                   # downgraded during planning. No filesense tool reads
                                                   # this value; filesense_sync always writes indexes.
export FRONTAGENT_FILESENSE_MAX_ENTRIES="300"
export FRONTAGENT_FILESENSE_MAX_BYTES="131072"
export FRONTAGENT_FILESENSE_TIMEOUT_MS="3000"

fa run "Explain React createElement" \
  --temperature 0.2 \
  --top-p 0.9

# Export the current cache directory as a distributable tar.gz bundle
fa rag export

# Export to a custom path
fa rag export --output ./artifacts/frontagent-rag-cache.tar.gz

# Import from a local file
fa rag import ./artifacts/frontagent-rag-cache.tar.gz --force

# Import from a remote URL
fa rag import https://example.com/frontagent-rag-cache.tar.gz --force

┌─────────────────────────────────────────────────────────────────────┐
│                         FrontAgent System                            │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌─────────────┐     ┌─────────────┐     ┌─────────────┐           │
│  │ User Input  │────▶│ Agent Core  │────▶│   Output    │           │
│  └─────────────┘     └──────┬──────┘     └─────────────┘           │
│                             │                                        │
│           ┌─────────────────┼─────────────────┐                     │
│           ▼                 ▼                 ▼                     │
│  ┌────────────────┐ ┌────────────┐ ┌────────────────┐              │
│  │  SDD Layer     │ │  Planner   │ │   Executor     │              │
│  │ (Constraints)  │ │ (Stage 1)  │ │   (Stage 2)    │              │
│  └───────┬────────┘ └─────┬──────┘ └───────┬────────┘              │
│          │                │                 │                       │
│          ▼                ▼                 ▼                       │
│  ┌──────────────────────────────────────────────────────┐          │
│  │           MCP Layer (Trusted Interface)               │          │
│  ├──────────────┬───────────────┬──────────────────────┤          │
│  │  MCP File    │   MCP Web     │     MCP Shell        │          │
│  └──────┬───────┴───────┬───────┴──────────┬───────────┘          │
└─────────┼───────────────┼──────────────────┼────────────────────────┘
          ▼               ▼                  ▼
   ┌──────────────┐ ┌──────────┐     ┌──────────┐
   │  File System │ │ Browser  │     │  Shell   │
   │  (Project)   │ │(Playwright)│    │Commands  │
   └──────────────┘ └──────────┘     └──────────┘

User Task
   │
   ▼
┌──────────────────┐
│  Pre-Planning    │ ← Scan project structure (NEW!)
│  File Scan       │   Detect dev server port (NEW!)
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  Planner (Stage1)│ ← SDD Constraints
└────────┬─────────┘   Project file list
         │             Dev server port
         │ Generates execution plan (with phase field)
         ▼
┌──────────────────────────────────────────┐
│           Executor (Stage 2)              │
│  ┌────────────────────────────────┐      │
│  │  Phase 1: Analysis              │      │
│  │  ├─ Step 1 ✓                  │      │
│  │  ├─ Step 2 ✗ (error)          │      │
│  │  └─ Error Recovery             │      │
│  │     ├─ Analyze error           │      │
│  │     ├─ Generate fix steps     │      │
│  │     └─ Execute fix ✓          │      │
│  └────────────────────────────────┘      │
│  ┌────────────────────────────────┐      │
│  │  Phase 2: Creation              │      │
│  │  ├─ Step 3 ✓                  │      │
│  │  └─ Step 4 ✓                  │      │
│  └────────────────────────────────┘      │
│                                           │
│  After each step:                         │
│  └─ Update Facts                          │
│     ├─ File system state                  │
│     ├─ Dependency state                   │
│     ├─ Module dependency graph            │
│     └─ Project state                      │
│                                           │
│  Phase completion validation:             │
│  └─ Check missing module references       │
│     └─ Auto-generate fix steps ✓          │
└───────────────────────────────────────────┘
         │
         ▼
    Task Complete ✓

// Automatically executed before planning
const projectStructure = await scanProjectFiles();
// Returns: "Project files (245 files): src/App.tsx, src/components/Button.tsx, ..."

// LLM receives this context and generates more accurate file paths

// Detection sources (in order):
// 1. vite.config.ts/js: server.port field
// 2. package.json scripts: --port or -p flags
// 3. Framework defaults: Vite (5173), Next.js (3000), CRA (3000), Angular (4200)
// 4. Fallback: 5173

const devServerPort = await detectDevServerPort();
// Used in browser navigation tasks

{
  "summary": "Create login page",
  "steps": [
    {
      "description": "Create Login.tsx component file",
      "action": "create_file",
      "params": {
        "path": "src/pages/Login.tsx",
        "codeDescription": "Create a React component with username, password inputs and login button"
      },
      "needsCodeGeneration": true
    }
  ]
}

{
  "steps": [
    {
      "stepId": "step-1",
      "phase": "Analysis Phase",
      "description": "Read existing files, analyze project structure",
      "action": "read_file"
    },
    {
      "stepId": "step-2",
      "phase": "Creation Phase",
      "description": "Create new component files",
      "action": "create_file"
    },
    {
      "stepId": "step-3",
      "phase": "Installation Phase",
      "description": "Install necessary dependencies",
      "action": "run_command"
    },
    {
      "stepId": "step-4",
      "phase": "Validation Phase",
      "description": "Run tests to verify functionality",
      "action": "run_command"
    },
    {
      "stepId": "step-5",
      "phase": "Repository Management Phase",
      "description": "Commit changes, push branch, and create/update PR with gh",
      "action": "run_command"
    }
  ]
}

// 1. Error detected
Error: Cannot apply patch: file not found in context: src/App.tsx

// 2. LLM analyzes error
{
  "canRecover": true,
  "analysis": "File src/App.tsx not read into context, need to read it first",
  "recoverySteps": [
    {
      "description": "Read src/App.tsx into context",
      "action": "read_file",
      "tool": "filesystem",
      "params": { "path": "src/App.tsx" }
    },
    {
      "description": "Reapply patch to src/App.tsx",
      "action": "apply_patch",
      "tool": "filesystem",
      "params": { /* original params */ }
    }
  ]
}

// 3. Auto-execute fix steps
// 4. Continue original flow

# Use native engine (default)
fa run "Add login page" --engine native

# Use LangGraph engine
fa run "Add login page" --engine langgraph

# LangGraph + checkpoint + custom recovery attempts
fa run "Add login page" --engine langgraph --langgraph-checkpoint --max-recovery-attempts 5

import { createAgent, type TaskPlanningSkill } from "@frontagent/core";

const agent = createAgent(config);

const customSkill: TaskPlanningSkill = {
  name: "task.security-audit",
  supports: (task) =>
    task.type === "debug" && task.description.includes("security"),
  plan: ({ stepFactory }) => [
    stepFactory.createStep({
      description: "Scan for security-sensitive patterns",
      action: "search_code",
      tool: "search_code",
      params: {
        pattern: "eval|innerHTML|dangerouslySetInnerHTML",
        filePattern: "src/**/*.{ts,tsx,js,jsx}",
      },
    }),
  ],
};

agent.registerTaskSkill(customSkill);
console.log(agent.getPlannerSkillSnapshot());

agent.registerExecutorActionSkill({
  name: "action.run-command.noncritical-policy",
  action: "run_command",
  shouldSkipToolError: ({ errorMsg, params }) => {
    if (typeof params.command === "string" && params.command.includes("echo")) {
      return true;
    }
    return errorMsg.includes("already exists");
  },
});
console.log(agent.getExecutorSkillSnapshot());

Executed operation log:
1. Attempted to read src/App.tsx - failed
2. Attempted to create src/components/Button.tsx - success
3. Attempted to read src/App.tsx - success
4. Installed react-router-dom - success
...(lots of redundant info)

## File System State

### Confirmed Existing Files:
- src/App.tsx
- src/components/Button.tsx
- package.json

### Confirmed Non-Existent Paths:
- src/pages/Login.tsx

## Dependency State

### Installed Packages:
react-router-dom, axios

### Missing Packages:
@types/node

## Created Modules

### component (3 modules):
- src/components/ui/Button.tsx (default export: Button)
- src/components/ui/Card.tsx (default export: Card)
- src/components/layout/Header.tsx (exports: Header, Navigation)

### page (2 modules):
- src/pages/HomePage.tsx (default export: HomePage)
- src/pages/LoginPage.tsx (default export: LoginPage)

### ⚠️ Missing Module References:
- src/pages/HomePage.tsx references non-existent module: ../components/ui/Spinner

## Project State
- Dev server: Running (port: 5173) ← Auto-detected!
- Build status: Success

## Recent Errors
- [apply_patch] Cannot apply patch: file not found in context

<projectRoot>/.frontagent/memory/
  MEMORY.md              # Index entrypoint (concise topic list)
  topics/
    project-structure.md  # Filesystem layout, key modules
    dependencies.md       # Packages, versions, known issues
    errors.md             # Past error resolutions
  snapshots/
    facts-latest.json     # Last ProjectFacts snapshot

const agent = createAgent({
  // ...other config
  memory: {
    enabled: true, // default: true
    preloadBudgetChars: 8000, // max chars injected at startup
    recallBudgetChars: 2000, // max chars per code-gen recall
    maxTopicFiles: 10, // max topic files loaded at startup
  },
});

# sdd.yaml
version: "1.0"

project:
  name: "my-project"
  type: "react-spa"

tech_stack:
  framework: "react"
  version: "^18.0.0"
  language: "typescript"
  forbidden_packages:
    - "jquery"
    - "lodash"

code_quality:
  max_function_lines: 50
  max_file_lines: 300
  forbidden_patterns:
    - "any"
    - "// @ts-ignore"

modification_rules:
  protected_files:
    - "package.json"
  require_approval:
    - pattern: "src/api/*"
      reason: "API layer changes require approval"

frontagent/
├── packages/
│   ├── shared/              # Shared types and utilities
│   ├── sdd/                 # SDD control layer
│   ├── mcp-file/            # File operations MCP client
│   ├── mcp-web/             # Web awareness MCP client
│   ├── mcp-shell/           # Shell commands MCP client
│   ├── hallucination-guard/ # Hallucination prevention
│   └── core/                # Agent core (two-stage architecture)
│       └── memory/          # Cross-session memory system
├── apps/
│   └── cli/                 # CLI tool
├── examples/
│   ├── sdd-example.yaml     # SDD config example
│   └── e-commerce-frontend/ # E-commerce frontend example
└── docs/
    ├── architecture.md      # Architecture design
    └── design.md            # Original requirements

cd examples
fa run "Create an e-commerce frontend project using React + TypeScript + Vite + Tailwind CSS"

fa run "Modify vite.config.ts to add path alias configuration"

fa run "Add user authentication feature, including login, registration, and token management"

fa run "Analyze and optimize homepage loading performance"

fa run "Add route configuration in App.tsx"

Phase 1: Analysis Phase
  ✓ Step 1: Read package.json

Phase 2: Creation Phase
  ✗ Step 2: Modify App.tsx
     Error: Cannot apply patch: file not found in context

  🔄 Error recovery in progress...
     Analysis: App.tsx not read into context

  ✓ Recovery Step 1: Read src/App.tsx into context
  ✓ Recovery Step 2: Reapply patch to App.tsx

Phase 3: Validation Phase
  ✓ Step 3: Run type check

✅ Task complete! Auto-fixed 1 error

fa run "Implement user profile page and open PR" \
  --type create \
  --engine langgraph \
  --langgraph-checkpoint \
  --max-recovery-attempts 5

Variable	Description	Example Value
`PROVIDER`	LLM provider	`openai` or `anthropic`
`API_KEY`	API key	`sk-...`
`MODEL`	Model name	`gpt-4` or `claude-sonnet-4-20250514`
`BASE_URL`	API endpoint	`https://api.openai.com/v1`
`EXECUTION_ENGINE`	Execution engine	`native` or `langgraph`
`LANGGRAPH_CHECKPOINT`	Enable LangGraph checkpoint	`true` / `false`
`MAX_RECOVERY_ATTEMPTS`	Max recovery attempts per phase	`3`

export PROVIDER="openai"
export BASE_URL="https://api.openai.com/v1"
export MODEL="gpt-4"
export API_KEY="sk-..."

export PROVIDER="anthropic"
export BASE_URL="https://api.anthropic.com"
export MODEL="claude-sonnet-4-20250514"
export API_KEY="sk-ant-..."

# Development mode
pnpm dev

# Type check
pnpm typecheck

# Build
pnpm build

# Clean
pnpm clean

pnpm build
pnpm --dir benchmarks/eval/fixture install                     # fixture deps (required)
node benchmarks/eval/run-eval.mjs --arm full --tasks all       # SDD on
node benchmarks/eval/run-eval.mjs --arm ablation --tasks all   # SDD off
node benchmarks/eval/report.mjs benchmarks/eval/out

# One-time: install fixture dependencies and materialise the generated module tree.
# The runner refuses to start without node_modules — a dangling symlink would
# otherwise turn every typecheck into a FAIL and record an arm of noise as data.
pnpm --dir benchmarks/eval/fixture-deep install
node benchmarks/eval/fixture-deep/generate.mjs

node benchmarks/eval/run-eval.mjs --arm full          --fixture deep --tasks all
node benchmarks/eval/run-eval.mjs --arm no-filesense  --fixture deep --tasks all
node benchmarks/eval/report-filesense.mjs benchmarks/eval/out deep

# macOS:  date -u -v-1d +%F   |  Linux:  date -u -d yesterday +%F
curl -s "https://api.npmjs.org/downloads/point/2026-01-14:$(date -u -v-1d +%F 2>/dev/null || date -u -d yesterday +%F)/frontagent" | jq

FrontAgent

Q: FrontAgent ถูกตรวจสอบล่าสุดเมื่อใด?

ตรวจสอบล่าสุดเมื่อ 2026-10-27 Frontend AI coding agent platform with CLI, VS Code extension, desktop app, MCP server, RAG planning, Skills, SDD guardrails, browser automation, and LoRA planner models | 面向前端工程的 AI Agent 平台，支持 CLI、VS Code 插件、桌面端、MCP 服务、RAG、Skills、SDD、浏览器自动化与 LoRA 规划模型

ceilf6120 ดาว

Frontend AI coding agent platform with CLI, VS Code extension, desktop app, MCP server, RAG planning, Skills, SDD guardrails, browser automation, and LoRA planner models | 面向前端工程的 AI Agent 平台，支持 CLI、V

Knowledge Memory Browser Automation

ติดตั้ง รันบน PlugMCPอ้างสิทธิ์เซิร์ฟเวอร์นี้

GitHub

รันบน PlugMCP

1# FrontAgent

README.mdเซิร์ฟเวอร์ MCP

ทรานสปอร์ต: stdio
สถานะ: โลคัล

เพิ่มเซิร์ฟเวอร์นี้

Host a copy with our keys and logs.

ข้อมูลเซิร์ฟเวอร์

เอกสารประกอบ

FrontAgent

Current Release Snapshot

Three Ways to Use FrontAgent

Endpoint trust in the VS Code extension

Desktop App

CLI Quick Start

MCP Server

Start the Server

Host Configuration

Exposed MCP Tools

LLM Backend Behavior

Security Model

Remote RAG

Skill Lab

Architecture Overview

System Architecture

Execution Flow

Key Features

1. Pre-Planning Project Scan (NEW!)

2. Automatic Dev Server Port Detection (NEW!)

3. Two-Stage Architecture

Stage 1: Planner

Stage 2: Executor

4. Phase-Based Execution & Self-Healing

Phase-Based Execution

Tool Error Feedback Loop

5. LangGraph Execution Engine (NEW!)

6. Planner Skills Layer (NEW!)

7. Facts-Based Context System

8. Cross-Session Memory System (NEW!)

Architecture

Storage Layout

Prompt Separation

Key Design Decisions

Configuration

Core Modules

@frontagent/sdd - SDD Control Layer

@frontagent/mcp-file - File Operations MCP

@frontagent/mcp-shell - Shell Command MCP

@frontagent/mcp-web - Web Awareness MCP

@frontagent/hallucination-guard - Hallucination Prevention

Tech Stack

Directory Structure

Usage Examples

Example 1: Create New Project

Example 2: Modify Existing Files

Example 3: Add New Features

Example 4: Performance Optimization

Example 5: Auto Error Recovery

Example 6: Enable LangGraph Engine

Environment Variables

Required Configuration

OpenAI Configuration Example

Anthropic Configuration Example

Development

Roadmap

Completed ✅

In Progress 🚧

Planned 📋

Friendly Links

Ablation Benchmark (reproducible)

Download Stats (verifiable)

Contributing

License

License

เกี่ยวกับ FrontAgent

เครื่องมือ

คำถาม

ติดตั้ง FrontAgent อย่างไร?

FrontAgent ต้องใช้ API key ไหม?

FrontAgent ใช้ทรานสปอร์ตแบบใด?

FrontAgent ถูกตรวจสอบล่าสุดเมื่อใด?