setup

Installs, starts, and updates the JobPilot terminal host on the local machine.

73|19|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/suxrobGM/jobpilot --skill setup-suxrobgm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/suxrobGM/jobpilot/tree/main/plugin/skills/setup
Command: npx skills add https://github.com/suxrobGM/jobpilot --skill setup-suxrobgm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting a local AI job-application agent running requires installing a terminal host, verifying it is healthy, keeping it updated, and connecting it to the web dashboard. This Skill automates that entire onboarding and maintenance flow so the agent can start working without manual setup steps. ## Core Features & Use Cases - Install and launch the terminal host: Detects whether the JobPilot host is installed and running on port 4102, installs it via the official one-liner for Windows, macOS, or Linux, and starts it detached so it outlives the session. - Health checks and recovery: Polls the local health endpoint, diagnoses port conflicts from stale processes, and restarts the host when needed. - Self-update management: Compares the running host version against the latest GitHub release and restarts to apply updates, plus instructions for refreshing the setup skill itself in Claude Code or Codex. - Use Case: After installing the JobPilot plugin, run this Skill once to get the local agent host running, then open the dashboard, sign in, and launch the agent to start searching and applying for jobs. ## Quick Start Run the setup skill to install and start the JobPilot terminal host on this machine, then open the dashboard to sign in and launch the agent.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the JobPilot agent on my machine?▼

Run the setup skill, which checks whether the terminal host is installed and installs it using the official one-liner for your OS. On Windows it uses a PowerShell irm command, and on macOS or Linux it uses a curl install script that places the binary in ~/.jobpilot.

How do I update the JobPilot terminal host to the latest version?▼

The setup skill compares the running hostVersion from the health endpoint against the latest GitHub release. If a newer version exists, it stops the running process and restarts the host, which self-updates on launch.

Does the JobPilot setup work on Windows, macOS, and Linux?▼

Yes, the setup skill provides separate commands for each platform. Windows uses PowerShell with Start-Process, while macOS and Linux use nohup to launch the host detached so it keeps running after the session ends.

Why does the JobPilot host fail to start on port 4102?▼

Startup usually fails because a stale jobpilot process already holds port 4102. Stop the old process with pkill -x jobpilot on macOS/Linux or Stop-Process on Windows, then relaunch and poll the health endpoint again.

Do I need an API token before running the setup skill?▼

No, the setup skill is safe to run without a token and handles installation before any authentication. If JOBPILOT_API_TOKEN is already set, the session is already inside the agent terminal and no installation is needed.