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
- A running Hub (docs/install.md).
- A truthful candidate profile. Do not invent one. Do not copy
candidate.example.yamlinto production. - At least one resume PDF in the tenant BlobStore (recommended at onboarding).
- A claimed role. Discovery never Easy Applies.
Sequence
-
Install Hub Default Compose binds 8787:
Same image on Railway / Coolify; details in install docs. This GitHub repo’s OCI host deploys on push todocker compose up -d --buildmain— that is one machine, not every clone. -
Onboard the candidate You are sent to /onboarding. Fill identity, titles, locations, and a resume PDF. Until
GET /api/candidate/statusisonboarded: true, jobs, invites, queues, messages, and A2A return409 candidate_required. -
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.
-
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 ownsskill.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.