Ghost 0.1.20

Ghost

Source attribution and final-diff AI policy enforcement for open source projects.

Repo owners define the policy. Contributors keep working with their agents. Ghost records surviving AI-authored lines and lets CI block only what would actually land in the pull request.

curl -sSL https://raw.githubusercontent.com/farhankhan197/ghost/main/install.sh | bash

Install Ghost Read the model

Ghost flow

Live

repo$ghost init

Ghost repository policy initialized

policy: ghost.yml

enforcement: scope=final_diff history=warn

binaries: ghost, ghost-checkpoint

owner policy will be read from the base branch during PR checks

cycling workflowCLI 0.1.20

Golden flow

Built around the merge decision, not old commit noise.

Owner policy

The base branch sets the rules.

Ghost reads policy from the protected branch, so a contributor cannot weaken the threshold inside the same pull request.

Agent capture

Supported agents are recorded automatically.

OpenCode, Codex, Claude Code, Cursor, and Antigravity edits are captured into repo-bound attribution sessions.

PR gate

The final diff is what gets enforced.

Boilerplate that disappears before merge becomes history context, not a false blocker for the current PR state.

Audit trail

Committed notes keep the provenance trail alive.

Git notes and signed policy checks preserve who or what authored surviving lines over time.

Enforcement

The policy is small, explicit, and owned by the repository.

Ghost now defaults to final PR diff enforcement. Historical AI use remains visible in audit output, but merge blocking follows the code that survives into the branch being reviewed.

Scopefinal_diff

Historywarn

Agentsopencode, codex, claude, cursor, antigravity

Enginelibgit2 backed

ghost.yml

threshold: 80%
required: false
on_exceed: block

enforcement:
  scope: final_diff
  history: warn

ghost verify-pr origin/main..HEAD --base origin/main

Open source provenance

Let maintainers accept AI-assisted work with clear boundaries.

CLI reference