GitBlixt
Docs Navigation

Scheduled Agents

A scheduled agent is a recurring AI task you define once and GitBlixt runs unattended on a schedule. Each run uses the same Claude Code pipeline as Fix with AI: the agent reads your repository, makes changes, and opens a merge request with the result. A scheduled agent never merges anything — a human always reviews the diff before it lands.

Typical uses: keeping dependencies or data tables current, applying a routine refactor, re-running a checklist against the codebase, or any task you would otherwise have to remember to do by hand every week or quarter.

How it works

  1. You create an agent in a repository's settings with a name, a cron schedule, a prompt, and a provider/model.
  2. Every 5 minutes GitBlixt checks for agents that are due, and queues a run for each one.
  3. The run executes Claude Code in an isolated Docker container against a fresh clone of the repository, branching off the agent's target branch.
  4. The agent runs your test suite and writes a merge request description that summarizes what changed and cites any external sources it used.
  5. If the agent made changes, GitBlixt opens a merge request (labeled ai-generated) for review. If nothing needed changing, no merge request is created and the run is recorded as "no changes".

Runs share the same per-repository concurrency and rate limits as other AI jobs. Each run appears in the agent's history with a link to its job log and resulting merge request.

Creating an agent

  1. Go to your repository's Settings page and open Scheduled Agents (or visit /<namespace>/<repo>/-/settings/agents).
  2. Click New agent and fill in:
    • Name — a label for the agent (e.g. "Update tax tables").
    • Schedule (cron) — a standard 5-field cron expression (minute hour day month weekday). The form previews the next run time as you type. For example, 0 9 1 * * runs at 09:00 on the 1st of every month.
    • Prompt — the task instructions. Be specific about what to change and where; the agent starts with no context beyond the repository and this prompt.
    • Provider / Model — which AI provider and model to use. The provider list is drawn from the keys you have configured in your account Settings.
    • Target branch (optional) — the branch to start from. Defaults to the repository's default branch.
    • Enabled — uncheck to pause the agent without deleting it.
  3. Save. The agent runs at its next scheduled time.

Use Run now on any agent to trigger a run immediately — handy for testing your prompt without waiting for the schedule.

Credentials

A scheduled run isn't tied to an interactive session, so it authenticates with the provider key of the user who created the agent. Usage is billed to that user's provider account, exactly as if they had run the job themselves.

If the creator's provider key is removed (or their account is deleted), GitBlixt automatically disables the agent and notifies the creator rather than failing silently. Re-add a key and re-enable the agent to resume.

Web access

Scheduled agents can fetch live external sources. In addition to reading and editing code, Claude Code has the WebFetch and WebSearch tools available, so an agent can consult primary sources (documentation, official data, release notes) and cite them in the merge request it opens.

Permissions

  • Only a repository's owner (or, for organization repositories, an organization owner) can view, create, edit, run, or delete scheduled agents.
  • Agents are scoped to a single repository — they only ever read and change that one repo.

The review gate

Because a scheduled agent always produces a merge request and never merges, every change it makes passes through your normal review process. To add stronger guardrails, configure your repository's approval rules, branch rules, and protected branches — an agent's merge request then requires the same approvals and passing CI as any human-authored one. See AI Assistant for details.

Global agents

A global agent is defined once, under Settings → Global AI agents, and targets multiple repositories you own instead of just one. Each scheduled run queues one AI job per target repository, running on that repository's default branch. A failure on one repository skips only that repository — the others still run. If the agent's API key goes missing or its model becomes invalid, GitBlixt disables the agent and notifies you, the same as it does for a per-repository agent.

Skills

A skill is a reusable instruction document, managed under Settings → AI Skills, that gets injected into every AI job — scheduled agents, issue fixes, MR reviews, and freeform runs alike. Reference a skill from an agent's prompt by name (e.g. "using the security-audit skill") to have it followed on that run.

Import a skill from any public SKILL.md URL, or start from the built-in library. Repositories can also commit their own .claude/skills/ directory; when a repo skill and an account skill share a name, the repo skill wins.