Skip to content

3. Your first job

Say what should happen and when. Claude writes the job, schedules it, records it in git and tests it.

  1. CloudCLI opens a chat in your repo. New Session starts another.

    Step 11: a new chat in CloudCLI, in the repo’s project.

  2. Not sure where to start? Say hi. Claude explains how jobs work and suggests some that fit your repo.

    Step 12: Claude explains and suggests jobs for the repo.

  3. Ask for a job in plain words, with when it should run. Here: “Every weekday at 8:00, list the open issues in my repo with a one-line summary each.”

    Claude writes the job’s instructions as a skill in your repo (here .claude/skills/open-issues-digest/SKILL.md), schedules the job in Paperclip and records it in .claude/jobs.json. It commits and pushes both.

    Step 13: asking for a job, and Claude’s answer with the skill, the job and the test run.

  4. Claude runs the job once as a test, waits for it to finish and reports the result, with links to Paperclip.

    Step 14: the test run’s result.

Open the Paperclip service’s address, with the same login.

  1. Routines lists your jobs. Each one shows its schedule, its next and last runs, and an on/off switch.

    Step 15: the job’s page in Paperclip, with its schedule, next run and Active switch.

  2. Each run is a task, where the Runner posts its result.

    Step 16: a task with the digest the run posted.

  3. Agents, Runner, Runs: every run’s status, model, tokens, duration and full transcript.

    Step 17: a run with its status, model and tokens.

  4. To change a job, ask Claude: a new time or new instructions, pause, resume, run now, or show the last log.

    Step 18: moving the digest to 9 and pausing it, by chat.

Claude made two commits in your repo:

  • the skill, .claude/skills/open-issues-digest/SKILL.md: what the job does;
  • the record, .claude/jobs.json: the job’s title, prompt, schedule, time zone and status.

Every later change to the job is another commit of .claude/jobs.json. See Jobs in git.

Paperclip (w/ CloudCLI) is a Railway template by AvgSoft. Paperclip, CloudCLI, Claude Code, Codex and Railway belong to their makers. Template codeDeploy on Railway