> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Server-side directory listing

> Lists one directory on the daemon's machine: subdirectories, plus files whose
extension has a registered extractor. The viewer's fallback file/folder picker for
systems with no native dialog; the browser never sees absolute paths from its own
file inputs, only what this endpoint returns.




## OpenAPI

````yaml /openapi.yaml get /context/browse
openapi: 3.1.0
info:
  title: memloom local API
  version: 0.1.0
  description: >
    The HTTP API served by the `memloom serve` daemon on your machine. The CLI,
    the MCP server,

    and the viewer all route through this API. The daemon is the single owner of
    the store, so

    every client shares one consistent view of your memories.


    No authentication: the daemon binds to `127.0.0.1` only and is reachable
    solely from your

    own machine. Browser clients on other localhost ports are allowed via CORS.
servers:
  - url: http://127.0.0.1:4319
    description: Local memloom daemon
security: []
paths:
  /context/browse:
    get:
      summary: Server-side directory listing
      description: >
        Lists one directory on the daemon's machine: subdirectories, plus files
        whose

        extension has a registered extractor. The viewer's fallback file/folder
        picker for

        systems with no native dialog; the browser never sees absolute paths
        from its own

        file inputs, only what this endpoint returns.
      operationId: browseContext
      parameters:
        - name: path
          in: query
          required: false
          schema:
            type: string
          description: Directory to list. Defaults to the home directory.
      responses:
        '200':
          description: The directory listing.
          content:
            application/json:
              schema:
                type: object
                properties:
                  path:
                    type: string
                  parent:
                    type: string
                    nullable: true
                    description: The parent directory, or null at the root.
                  entries:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        path:
                          type: string
                        kind:
                          type: string
                          enum:
                            - dir
                            - file
        '400':
          description: Cannot read that directory.

````