--- title: "overlane repo show" description: "Show one repository, or one commit with its full diff" --- > Documentation Index > Fetch the complete documentation index at: https://docs.overlane.app/llms.txt > Use this file to discover all available pages before exploring further. # overlane repo show {/* Generated by apps/docs/scripts/generate.mjs (CLI pages from the command registry in packages/cli). Do not edit; run `pnpm --filter @overlane/docs gen`. */} Without a commit, shows a repository's record; the remote URL carries no credential, so use `overlane repo token` for a scoped token and hand it to a git credential helper. With a commit (a SHA or a branch), shows its message and the full diff against its first parent: unified text by default, --stat for counts only, --json for the structured diff. ## Usage ```sh overlane repo show repo [commit] [--stat] ``` ## Arguments | Argument | Required | Description | | --- | --- | --- | | `repo` | yes | The repository name or ID | | `commit` | no | A commit SHA or branch to show with its diff | ## Flags | Flag | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `--stat` | boolean | no | | Counts per file only, no hunks | ## Examples ```sh overlane repo show app overlane repo show app 4f2a9c1 overlane repo show app main --stat overlane repo show app feature/add --json ``` ## Behavior - Effect: `read` (changes nothing). - Needs credentials: yes. Uses the network: yes. - Supports `--dry-run`: no. Accepts `--force`: no. - Machine-readable description: `overlane schema repo show`. ## Result With `--json` (the default when stdout is not a terminal) the command prints this JSON Schema's shape on stdout. ```json { "anyOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "1" }, "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$", "description": "tenant identifier" }, "projectId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$", "description": "project identifier" }, "repoId": { "type": "string", "pattern": "^repo_[A-Za-z0-9]{6,40}$" }, "name": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,62}$" }, "provider": { "type": "string", "enum": [ "overlane", "github", "gitlab" ] }, "mode": { "type": "string", "enum": [ "native", "github-only" ] }, "defaultBranch": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9._/-]+$" }, "sizeBytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "capBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "remote": { "type": "string", "maxLength": 500 }, "mirror": { "anyOf": [ { "type": "object", "properties": { "external": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "github", "gitlab" ] }, "owner": { "type": "string", "minLength": 1, "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "provider", "owner", "name" ], "additionalProperties": false }, "writableSide": { "type": "string", "enum": [ "overlane", "external" ] }, "lastSyncedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] }, "lastSyncedSha": { "anyOf": [ { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" }, { "type": "null" } ] } }, "required": [ "external", "writableSide", "lastSyncedAt", "lastSyncedSha" ], "additionalProperties": false }, { "type": "null" } ] }, "createdBy": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "user", "agent" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": [ "kind", "id" ], "additionalProperties": false }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "deletedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "schemaVersion", "tenantId", "projectId", "repoId", "name", "provider", "mode", "defaultBranch", "sizeBytes", "capBytes", "remote", "mirror", "createdBy", "createdAt", "deletedAt" ], "additionalProperties": false }, { "type": "object", "properties": { "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$", "description": "tenant identifier" }, "repoId": { "type": "string", "pattern": "^repo_[A-Za-z0-9]{6,40}$" }, "commit": { "type": "object", "properties": { "sha": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" }, "parents": { "type": "array", "items": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" } }, "message": { "type": "string" } }, "required": [ "sha", "parents", "message" ], "additionalProperties": false }, "diff": { "type": "object", "properties": { "base": { "anyOf": [ { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" }, { "type": "null" } ] }, "head": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" }, "files": { "maxItems": 3000, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 1000 }, "previousPath": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 1000 }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "added", "modified", "deleted", "renamed", "binary" ] }, "additions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "deletions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "hunks": { "type": "array", "items": { "type": "object", "properties": { "oldStart": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "oldLines": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "newStart": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "newLines": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lines": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "context", "add", "delete" ] }, "oldLine": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "newLine": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "text": { "type": "string" }, "noNewline": { "type": "boolean" } }, "required": [ "type", "oldLine", "newLine", "text" ], "additionalProperties": false } } }, "required": [ "oldStart", "oldLines", "newStart", "newLines", "lines" ], "additionalProperties": false } } }, "required": [ "path", "previousPath", "status", "additions", "deletions", "truncated", "hunks" ], "additionalProperties": false } }, "totals": { "type": "object", "properties": { "files": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "additions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "deletions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "files", "additions", "deletions" ], "additionalProperties": false }, "truncated": { "type": "boolean" }, "truncatedReason": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] } }, "required": [ "base", "head", "files", "totals", "truncated", "truncatedReason" ], "additionalProperties": false }, "view": { "type": "string", "enum": [ "stat" ] } }, "required": [ "tenantId", "repoId", "commit", "diff" ], "additionalProperties": false } ] } ``` See [exit codes](/cli/#exit-codes) for the status the process returns. Source: https://docs.overlane.app/cli/repo-show/index.mdx