301→302301→302
A temporary redirect where a permanent one belongs.
Found by Redirect checker →
redirect loopredirect loop
The URL redirects back to itself and never settles.
Found by Redirect checker →
Interfaces

SEO projects and agent handoff

A project directory keeps the site, scope, crawl policy, checklist coverage, scans, saved views and run history; workflow runs checkpoint each step so another agent can resume.

SEO projects and agent handoff

Inbox and observer

seohead watch opens a terminal observer beside the chat; the inbox keeps the specialist's notes and proposed goals.

SEO projects and agent handoff

Task is not proof

A completed task is not treated as proof that a site error was fixed.

How it works

Three steps, one saved scan

  1. Create one project directory

    seohead project new --directory ./shop --target https://example.com/ writes a local folder with the site, scans, reports and a log that you can move as a whole.

  2. Track the agreed checklist

    Checklist items show what is remaining, blocked, stale or waiting for review. A finished task is recorded as a task, not as proof that the site error is fixed.

  3. Hand off a checkpointed run

    A workflow run closes steps in order with retained evidence hashes. Another agent resumes at the first unfinished step with workflow-resume.

What it checks

Checks in this feature

CheckWhat it meansSeverityEvidence
BROKEN_PAGE_4XXPage returns a 4xx response; the project keeps it as an open item until a recheck shows it fixedCriticalStatus code and URL in the saved scan
REDIRECT_LOOPRedirect chain never reaches a valid destinationCriticalRedirect chain in the saved scan
REDIRECT_CHAINTwo or more redirect hops before the final URLImportantRedirect chain in the saved scan
TITLE_MISSINGTitle element is missingCriticalPage row in the saved scan
CANONICAL_MISSINGIndexable page has no canonical URLImportantPage row in the saved scan
How to run it

One command

bash
seohead project new --directory ./shop --target https://example.com/

Install first: installation guide. Every command also runs as an MCP tool for AI agents.

FAQ

Questions

SEO projects and agent handoff
No. Projects work from the CLI and the MCP server. seohead watch --project DIR opens an optional terminal observer that shows coverage and findings. Its only writes are notes and proposed goals that you save yourself.
No. Project commands such as project-inbox-submit, workflow-start and checkpoints only record state. Crawls run only through explicit commands such as crawl-site or project-prepare.
Not silently. Every write takes the current revision (expected_revision) and fails on a conflict, so the second writer must read the latest state first.
No. The only percentage is labelled Audit-task completion, and it appears only after an explicit plan. It does not measure site health or remediation.
Project archive writes one zip with a SHA-256 manifest and skips credential-like file names. Restore publishes it only to a new path, never over an existing directory. Project data is working material, not a public export.

Check your redirects locally