A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

objects.list

List objects

What it is

List the declarative objects of the repository's AI layer, optionally by kind or tag.

Descriptor

Canonical id: objects.list
Module: objects
Kind: query
Stability: behaviorallyverified
Provenance: declared
Source: apps/majordomus-cli/src/capability/builtin/objects.rs
Cache: disabled
Benchmark: required
Tags: objects

Run

query

A query. It reads and changes nothing.

Projections

Interface	As	Where
MCP tool	`majordomus_list`	-
MCP resource	not exposed	-
HTTP	`GET /api/v1/objects`	Swagger
Command line	not exposed	-

Schemas

Input · ListInput

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "kind": {
      "type": [
        "string",
        "null"
      ],
      "description": "Only objects of this kind; the kinds present are listed by `repository.info`. A kind\nthe repository does not have is an invalid input, not an empty answer.",
      "default": null
    },
    "tag": {
      "type": [
        "string",
        "null"
      ],
      "description": "Only objects whose metadata tags include this tag.",
      "default": null
    }
  },
  "description": "Filters; both optional.",
  "title": "ListInput"
}

Output · ObjectList

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "format": "uint",
      "minimum": 0,
      "description": "How many objects matched."
    },
    "objects": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ObjectSummary"
      },
      "description": "The objects, one summary each."
    }
  },
  "required": [
    "count",
    "objects"
  ],
  "description": "The answer of `objects.list`: the matching objects, summarised, in URI order.",
  "title": "ObjectList",
  "$defs": {
    "ObjectSummary": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "description": "`majordomus://<kind>/<identity>`."
        },
        "id": {
          "type": "string",
          "description": "The capability id, `<kind>.<identity>`."
        },
        "kind": {
          "type": "string",
          "description": "The kind the object was read as."
        },
        "identity": {
          "type": "string",
          "description": "The identity within the kind."
        },
        "title": {
          "type": [
            "string",
            "null"
          ],
          "description": "The title, when the kind's title rule found one."
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "The one-line description, when the kind holds one."
        },
        "path": {
          "type": "string",
          "description": "Repository-relative source path."
        }
      },
      "required": [
        "uri",
        "id",
        "kind",
        "identity",
        "path"
      ],
      "description": "One object, summarised for a listing."
    }
  }
}

Examples

These are the capability's own benchmark cases: the same inputs the benchmark runs and the OpenAPI document shows.

all

{
  "kind": null,
  "tag": null
}

first-kind

{
  "kind": "adr",
  "tag": null
}