{
  "id": "oxen",
  "name": "Oxen",
  "homepage": "https://www.oxen.ai/",
  "description": "Data VCS for structured and unstructured machine learning datasets",
  "executables": [
    "oxen"
  ],
  "dotfiles": {
    "paths": [],
    "secret": [
      "~/.config/oxen/auth_config.toml",
      "~/.oxen/user_config.toml"
    ]
  },
  "commands": {
    "format": 1,
    "label": "Oxen",
    "description": "Common Oxen version-control jobs: add, commit, clone and push. Other subcommands are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "add"
        ],
        "label": "Stage files",
        "source": [
          {
            "id": "src",
            "kind": "help",
            "url": "https://github.com/Oxen-AI/Oxen/blob/HEAD/crates/oxen-cli/src/cmd/add.rs",
            "revision": "HEAD 2026-10-27",
            "evidence": ".about(\"Adds the specified files or directories\")\nArg::new(\"files\")\n"
          }
        ],
        "field": [
          {
            "id": "files",
            "label": "Files or directories",
            "type": "path",
            "path": {
              "kind": "any",
              "role": "input"
            },
            "position": 0,
            "multiple": true,
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "add",
            "label": "Stage files",
            "fields": [
              "files"
            ],
            "required": [
              "files"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "files"
            ]
          }
        ]
      },
      {
        "path": [
          "commit"
        ],
        "label": "Commit staged files",
        "source": [
          {
            "id": "src",
            "kind": "help",
            "url": "https://github.com/Oxen-AI/Oxen/blob/HEAD/crates/oxen-cli/src/cmd/commit.rs",
            "revision": "HEAD 2026-10-27",
            "evidence": ".about(\"Commit the staged files to the repository.\")\n.help(\"The message for the commit. Should be descriptive about what changed.\")\n.long(\"message\") --message\n.short('m') -m\n.help(\"Allow creating a commit with no changes\")\n.long(\"allow-empty\") --allow-empty\n"
          }
        ],
        "field": [
          {
            "id": "message",
            "label": "Commit message",
            "type": "string",
            "option": [
              "--message",
              "-m"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "allow_empty",
            "label": "Allow empty commit",
            "type": "boolean",
            "option": [
              "--allow-empty"
            ],
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "commit",
            "label": "Commit",
            "fields": [
              "message"
            ],
            "required": [
              "message"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "message",
              "allow_empty"
            ]
          }
        ]
      },
      {
        "path": [
          "clone"
        ],
        "label": "Clone a repository",
        "source": [
          {
            "id": "src",
            "kind": "help",
            "url": "https://github.com/Oxen-AI/Oxen/blob/HEAD/crates/oxen-cli/src/cmd/clone.rs",
            "revision": "HEAD 2026-10-27",
            "evidence": ".about(\"Clone a repository by its URL\")\n.long(\"filter\") --filter\n.long(\"depth\") --depth\n.long(\"all\") --all\n.short('a') -a\n.long(\"branch\") --branch\n.short('b') -b\n.help(\"The branch you want to pull to when you clone.\")\n"
          }
        ],
        "field": [
          {
            "id": "url",
            "label": "Repository URL",
            "type": "url",
            "position": 0,
            "sources": [
              "src"
            ]
          },
          {
            "id": "branch",
            "label": "Branch",
            "type": "string",
            "option": [
              "--branch",
              "-b"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "all",
            "label": "Full history and data",
            "type": "boolean",
            "option": [
              "--all",
              "-a"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "filter",
            "label": "Directory filter",
            "type": "string",
            "option": [
              "--filter"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "depth",
            "label": "Subtree depth",
            "description": "Used together with the filter.",
            "type": "integer",
            "option": [
              "--depth"
            ],
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "clone",
            "label": "Clone",
            "fields": [
              "url",
              "branch"
            ],
            "required": [
              "url"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "url",
              "branch",
              "all",
              "filter",
              "depth"
            ]
          }
        ]
      },
      {
        "path": [
          "push"
        ],
        "label": "Push to a remote",
        "source": [
          {
            "id": "src",
            "kind": "help",
            "url": "https://github.com/Oxen-AI/Oxen/blob/HEAD/crates/oxen-cli/src/cmd/push.rs",
            "revision": "HEAD 2026-10-27",
            "evidence": ".about(\"Push the files to the remote branch\")\n.help(\"Remote you want to push to\")\n.help(\"Branch name to push to\")\n.long(\"delete\") --delete\n.short('d') -d\n.help(\"Remove the remote branch\")\n.long(\"force\") --force\n.short('f') -f\n.help(\"Force push even if the remote branch is not a fast-forward\")\n"
          }
        ],
        "field": [
          {
            "id": "remote",
            "label": "Remote",
            "type": "string",
            "position": 0,
            "sources": [
              "src"
            ]
          },
          {
            "id": "branch",
            "label": "Branch",
            "type": "string",
            "position": 1,
            "sources": [
              "src"
            ]
          },
          {
            "id": "delete",
            "label": "Delete the remote branch",
            "type": "boolean",
            "option": [
              "--delete",
              "-d"
            ],
            "effect": "delete",
            "sources": [
              "src"
            ]
          },
          {
            "id": "force",
            "label": "Force push",
            "type": "boolean",
            "option": [
              "--force",
              "-f"
            ],
            "effect": "overwrite",
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "push",
            "label": "Push",
            "fields": [
              "remote",
              "branch"
            ],
            "required": [
              "remote",
              "branch"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "remote",
              "branch",
              "delete",
              "force"
            ]
          }
        ]
      }
    ]
  }
}