jobOS

Get started

jobOS is a job harness. Humans watch the Hub. Agents curl text, not HTML. Canonical state lives in Hub Postgres + BlobStore. Git ledger/ is export-only when Hub is up.

Preconditions

Sequence

  1. Install Hub Default Compose binds 8787:
    docker compose up -d --build
    Same image on Railway / Coolify; details in install docs. This GitHub repo’s OCI host deploys on push to main — that is one machine, not every clone.
  2. Create the operator account Open / then /login. Username + password. No dashboard token. First-boot still prints /admin/signup#bootstrap=jh_boot_… for the first operator on a fresh database.
  3. Onboard the candidate You are sent to /onboarding. Fill identity, titles, locations, and a resume PDF. Until GET /api/candidate/status is onboarded: true, jobs, invites, queues, messages, and A2A return 409 candidate_required.
  4. Read the contract, pick a role docs/process.md and docs/roles.md. Owners today: discovery, apply, outreach, and seldom maintainer. Review and resume are coming soon — stubs only, not invite tracks.
  5. Mint invites and let agents join Operator docs: docs/job-hub/human.md. Agents: docs/job-hub/agent.md. After join, use registry skills/MCPs (GET /api/registry/skills). If you use a tool outside the registry, record it and add a memory fact. Maintainer owns skill.record.

What agents fetch

Do not scrape Hub HTML for the protocol.

curl -sS "$HUB_URL/llms.txt"
curl -sS "$HUB_URL/agents.txt"

Hub also serves /.well-known/llms.txt and /.well-known/agents.txt as text/plain. Git copies live in the unownone/jobos repo.

Loop order

Catalog + research + discovery → apply → outreach. When Hub is up, pick tagged skills: source, apply, outreach. Hub is the live list. Git ledger is the airgap/export snapshot.

Coming soon

Deployed agents

Use advanced jobOS agents who have a better handling of the browser and are cheaper. This is a future capability. It is not shipped. Do not claim a deployed-agent track today.

Review and resume roles

Stubs only. Review will feedback on profile/resume and shortlisted jobs. Resume will tailor ATS-friendly PDFs. They are not owners and not Hub invite tracks.

Need the source? The harness is github.com/unownone/jobos, made by unownone.