Menu
Use when asked to run, launch, start, test, or smoke-test the Jianmen bastion application (backend or frontend)
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
| name | run-jianmen |
| description | Use when asked to run, launch, start, test, or smoke-test the Jianmen bastion application (backend or frontend) |
Jianmen is a bastion/jump server โ Go backend (SSH/SFTP gateway, Admin API, DB proxy) + Vue 3 frontend (management UI). This skill covers the full build-and-launch pipeline for local development.
| Tool | Version | Check |
|---|---|---|
| Go | 1.23+ | go version |
| Node.js | 18+ | node --version |
| npm | 9+ | npm --version |
The backend creates data/ at runtime (database, host keys, replays). No manual setup needed.
.\scripts\start.ps1
Handles cleanup, config, build, npm install (first time), process startup, and readiness checks. It exits non-zero and prints recent logs when any service fails. Output shows URLs, log paths, PID files, and access token.
Get-Process -Name "jianmen" -ErrorAction SilentlyContinue | Stop-Process -Force
Get-Process -Name "node" -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep -Seconds 1
# Copy config template (first time only)
if (-not (Test-Path config.local.json)) { Copy-Item configs/config.example.json config.local.json }
# Build and run
New-Item -ItemType Directory -Force -Path logs,bin | Out-Null
go build -o bin\jianmen.exe .\cmd\jianmen
$backend = Start-Process -FilePath ".\bin\jianmen.exe" -ArgumentList "-config", "config.local.json" -RedirectStandardOutput "logs\backend.log" -RedirectStandardError "logs\backend.err.log" -PassThru
Set-Content logs\backend.pid $backend.Id
cd web
if (-not (Test-Path node_modules)) { npm install }
$frontend = Start-Process -FilePath "npm.cmd" -ArgumentList "run", "dev", "--", "--host", "127.0.0.1", "--strictPort" -RedirectStandardOutput "..\logs\frontend.log" -RedirectStandardError "..\logs\frontend.err.log" -PassThru
Set-Content ..\logs\frontend.pid $frontend.Id
| Check | Command |
|---|---|
| Admin API (curl) | curl -s --noproxy '*' http://127.0.0.1:47100/api/health |
| Admin API with auth | curl -s --noproxy '*' -H "Authorization: Bearer dev-admin-token" http://127.0.0.1:47100/api/hosts |
| Web UI (PowerShell) | (Invoke-WebRequest 'http://127.0.0.1:47101/' -UseBasicParsing).StatusCode |
| Frontend proxy to backend | (Invoke-WebRequest 'http://127.0.0.1:47101/api/hosts' -UseBasicParsing -Headers @{'Authorization'='Bearer dev-admin-token'}).Content |
| SSH gateway | ssh -p 47102 admin@127.0.0.1 (password: admin) |
Proxy note: If a system-wide http_proxy is set (e.g. 127.0.0.1:7890), curl routes localhost traffic through it and gets 502. Use --noproxy '*' or PowerShell Invoke-WebRequest as fallback.
| Service | Bind Address | Config Key |
|---|---|---|
| Admin API | 127.0.0.1:47100 (IPv4) | admin.listen_addr |
| Vue dev server | 127.0.0.1:47101 (IPv4) | Vite config server.host + server.port |
| SSH/SFTP gateway | 0.0.0.0:47102 | listen_addr |
The Vue dev server proxies /api requests to the Admin API (default http://localhost:47100), configured in web/vite.config.ts.
| Symptom | Cause | Fix |
|---|---|---|
config.local.json not found | First run, config not copied | Copy configs/config.example.json โ config.local.json |
| Port 47100/47101/47102/33060 in use | Previous instance still running | Run ./scripts/start.ps1; it cleans PID files and fixed ports before restart |
Script exits with Startup failed | A readiness check failed | Read the log tail printed by the script, then inspect logs/backend.err.log, logs/backend.log, logs/frontend.err.log, logs/frontend.log |
| Backend starts but curl returns empty/502 | System http_proxy env var routing localhost through external proxy | Use --noproxy '*' with curl, or PowerShell Invoke-WebRequest |
| Frontend API calls fail | Backend not running | Start backend before frontend |
| go build fails | Missing Go dependencies | Run go mod download |
| npm run dev fails | node_modules missing or stale | cd web then run npm install |
After launch, drive it to confirm it works:
# Smoke test: Admin API with auth token
(Invoke-WebRequest 'http://127.0.0.1:47100/api/hosts' -UseBasicParsing -Headers @{Authorization='Bearer dev-admin-token'}).Content
# Verify frontend serves HTML
(Invoke-WebRequest 'http://127.0.0.1:47101/' -UseBasicParsing).StatusCode
# Verify frontend proxies /api to backend
(Invoke-WebRequest 'http://127.0.0.1:47101/api/hosts' -UseBasicParsing -Headers @{Authorization='Bearer dev-admin-token'}).Content