{"$schema":"http:\/\/json-schema.org\/draft-07\/schema#","$id":"https:\/\/gojo.rocks\/schemas\/gojo.json","title":"gojo configuration","description":"Configuration for ~\/.config\/gojo\/gojo.toml. All settings are optional. This schema describes the standalone file, not the surrounding jj config.toml.","type":"object","additionalProperties":false,"properties":{"ai_provider":{"type":"string","enum":["api","codex",""],"default":"api","description":"AI commit message provider: api uses an OpenAI-compatible endpoint; codex uses the Codex CLI's saved login. Empty selects api."},"ai_api_key":{"type":"string","description":"Bearer token for the API provider. Not needed for Codex."},"ai_base_url":{"type":"string","default":"https:\/\/openrouter.ai\/api\/v1","description":"OpenAI-compatible API root, without \/chat\/completions. Empty uses OpenRouter. Ignored by Codex."},"ai_model":{"type":"string","description":"Model name. Empty uses anthropic\/claude-sonnet-4 for api, or the Codex CLI's configured default for codex."},"commit_prompt":{"type":"string","description":"Custom prompt for AI commit messages; the diff is appended to it. Empty uses the built-in subject-only prompt. Use a single-line string."},"theme":{"type":"string","default":"gojo","examples":["gojo","terminal","dracula"],"description":"Theme ID (file stem), including custom themes from ~\/.config\/gojo\/themes. Empty selects gojo."},"openrouter_api_key":{"type":"string","description":"Legacy alias for ai_api_key. Prefer ai_api_key; if both appear, the last value in the file wins."},"openrouter_base_url":{"type":"string","description":"Legacy alias for ai_base_url. Prefer ai_base_url; if both appear, the last value in the file wins."},"openrouter_model":{"type":"string","description":"Legacy alias for ai_model. Prefer ai_model; if both appear, the last value in the file wins."},"keymap":{"type":"object","description":"Write unquoted context.action dotted keys under [keymap], e.g. log.down = \"j,down\". TOML represents these as nested objects. gojo's minimal parser requires this spelling; do not use [keymap.log], quoted dotted keys, or inline tables.","additionalProperties":false,"properties":{"global":{"type":"object","description":"Global shortcuts.","additionalProperties":false,"properties":{"quit":{"$ref":"#\/definitions\/binding"},"force_quit":{"$ref":"#\/definitions\/binding"},"help":{"$ref":"#\/definitions\/binding"}}},"boot":{"type":"object","description":"Repository initialization and boot error screens.","additionalProperties":false,"properties":{"yes":{"$ref":"#\/definitions\/binding"},"no":{"$ref":"#\/definitions\/binding"},"quit":{"$ref":"#\/definitions\/binding"},"back":{"$ref":"#\/definitions\/binding"}}},"elevate":{"type":"object","description":"Elevation retry prompt.","additionalProperties":false,"properties":{"confirm":{"$ref":"#\/definitions\/binding"}}},"menu":{"type":"object","description":"Right-click context menu.","additionalProperties":false,"properties":{"close":{"$ref":"#\/definitions\/binding"},"accept":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"}}},"input":{"type":"object","description":"Shared text-input editing.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"accept":{"$ref":"#\/definitions\/binding"},"complete":{"$ref":"#\/definitions\/binding"},"erase":{"$ref":"#\/definitions\/binding"},"clear":{"$ref":"#\/definitions\/binding"}}},"log":{"type":"object","description":"Commit list.","additionalProperties":false,"properties":{"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"open":{"$ref":"#\/definitions\/binding"},"search":{"$ref":"#\/definitions\/binding"},"describe":{"$ref":"#\/definitions\/binding"},"ai_describe":{"$ref":"#\/definitions\/binding"},"edit":{"$ref":"#\/definitions\/binding"},"new":{"$ref":"#\/definitions\/binding"},"abandon":{"$ref":"#\/definitions\/binding"},"all_rev":{"$ref":"#\/definitions\/binding"},"conflict":{"$ref":"#\/definitions\/binding"},"bookmark":{"$ref":"#\/definitions\/binding"},"tag":{"$ref":"#\/definitions\/binding"},"files":{"$ref":"#\/definitions\/binding"},"git":{"$ref":"#\/definitions\/binding"},"undo":{"$ref":"#\/definitions\/binding"},"redo":{"$ref":"#\/definitions\/binding"},"rebase":{"$ref":"#\/definitions\/binding"},"squash":{"$ref":"#\/definitions\/binding"},"absorb":{"$ref":"#\/definitions\/binding"},"theme":{"$ref":"#\/definitions\/binding"},"workspace":{"$ref":"#\/definitions\/binding"}}},"diff":{"type":"object","description":"Diff panel.","additionalProperties":false,"properties":{"close":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"collapse":{"$ref":"#\/definitions\/binding"},"expand":{"$ref":"#\/definitions\/binding"},"conflict":{"$ref":"#\/definitions\/binding"},"describe":{"$ref":"#\/definitions\/binding"},"ai_describe":{"$ref":"#\/definitions\/binding"},"new":{"$ref":"#\/definitions\/binding"},"split":{"$ref":"#\/definitions\/binding"},"absorb":{"$ref":"#\/definitions\/binding"}}},"split":{"type":"object","description":"Interactive split mode.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"confirm":{"$ref":"#\/definitions\/binding"},"toggle":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"collapse":{"$ref":"#\/definitions\/binding"},"expand":{"$ref":"#\/definitions\/binding"}}},"help":{"type":"object","description":"Help view scrolling.","additionalProperties":false,"properties":{"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"}}},"search":{"type":"object","description":"Revision search overlay.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"accept":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"erase":{"$ref":"#\/definitions\/binding"},"clear":{"$ref":"#\/definitions\/binding"}}},"rebase":{"type":"object","description":"Rebase destination picking.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"scope":{"$ref":"#\/definitions\/binding"},"place":{"$ref":"#\/definitions\/binding"},"confirm":{"$ref":"#\/definitions\/binding"}}},"squash":{"type":"object","description":"Squash destination picking.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"confirm":{"$ref":"#\/definitions\/binding"}}},"bookmark":{"type":"object","description":"Bookmark menu.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"create":{"$ref":"#\/definitions\/binding"},"delete":{"$ref":"#\/definitions\/binding"},"forget":{"$ref":"#\/definitions\/binding"},"list":{"$ref":"#\/definitions\/binding"},"move":{"$ref":"#\/definitions\/binding"},"rename":{"$ref":"#\/definitions\/binding"},"set":{"$ref":"#\/definitions\/binding"},"track":{"$ref":"#\/definitions\/binding"},"untrack":{"$ref":"#\/definitions\/binding"}}},"tag":{"type":"object","description":"Tag menu.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"set":{"$ref":"#\/definitions\/binding"},"move":{"$ref":"#\/definitions\/binding"},"delete":{"$ref":"#\/definitions\/binding"},"list":{"$ref":"#\/definitions\/binding"},"push":{"$ref":"#\/definitions\/binding"}}},"git":{"type":"object","description":"Git fetch\/push menu.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"fetch":{"$ref":"#\/definitions\/binding"},"push":{"$ref":"#\/definitions\/binding"},"push_bookmark":{"$ref":"#\/definitions\/binding"},"remote":{"$ref":"#\/definitions\/binding"}}},"remote":{"type":"object","description":"Git remote menu.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"add":{"$ref":"#\/definitions\/binding"},"list":{"$ref":"#\/definitions\/binding"},"remove":{"$ref":"#\/definitions\/binding"},"rename":{"$ref":"#\/definitions\/binding"},"set_url":{"$ref":"#\/definitions\/binding"}}},"rename":{"type":"object","description":"Bookmark\/tag rename input.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"accept":{"$ref":"#\/definitions\/binding"},"erase":{"$ref":"#\/definitions\/binding"}}},"conflict":{"type":"object","description":"Conflict resolution view. left\/right\/both\/unset choose content; apply resolves the file.","additionalProperties":false,"properties":{"close":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"prev_file":{"$ref":"#\/definitions\/binding"},"next_file":{"$ref":"#\/definitions\/binding"},"left":{"$ref":"#\/definitions\/binding"},"right":{"$ref":"#\/definitions\/binding"},"both":{"$ref":"#\/definitions\/binding"},"unset":{"$ref":"#\/definitions\/binding"},"apply":{"$ref":"#\/definitions\/binding"}}},"picker":{"type":"object","description":"File tree picker.","additionalProperties":false,"properties":{"quit":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"expand":{"$ref":"#\/definitions\/binding"},"collapse":{"$ref":"#\/definitions\/binding"},"open":{"$ref":"#\/definitions\/binding"}}},"fzf":{"type":"object","description":"Inline fuzzy file finder.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"accept":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"erase":{"$ref":"#\/definitions\/binding"},"clear":{"$ref":"#\/definitions\/binding"}}},"blame":{"type":"object","description":"File blame view.","additionalProperties":false,"properties":{"back":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"history":{"$ref":"#\/definitions\/binding"},"open":{"$ref":"#\/definitions\/binding"}}},"history":{"type":"object","description":"File history view.","additionalProperties":false,"properties":{"back":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"open":{"$ref":"#\/definitions\/binding"}}},"theme":{"type":"object","description":"Theme picker with live preview.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"apply":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"}}},"workspace":{"type":"object","description":"Workspace manager.","additionalProperties":false,"properties":{"cancel":{"$ref":"#\/definitions\/binding"},"open":{"$ref":"#\/definitions\/binding"},"up":{"$ref":"#\/definitions\/binding"},"down":{"$ref":"#\/definitions\/binding"},"top":{"$ref":"#\/definitions\/binding"},"bottom":{"$ref":"#\/definitions\/binding"},"page_up":{"$ref":"#\/definitions\/binding"},"page_down":{"$ref":"#\/definitions\/binding"},"add":{"$ref":"#\/definitions\/binding"},"rename":{"$ref":"#\/definitions\/binding"},"forget":{"$ref":"#\/definitions\/binding"},"update":{"$ref":"#\/definitions\/binding"}}}}}},"definitions":{"binding":{"type":"string","description":"Comma-separated key names, replacing all defaults for this action. Empty unbinds it; omitted keeps the defaults. Names are case-sensitive (e.g. q versus Q); enter, esc, space, up, pgup, pgdown, ctrl+u and friendly aliases such as escape\/pgdn are supported. The first key appears in UI hints.","examples":["j,down","ctrl+u",""]}}}