semly(1) — Extended help for the Semly CLI

OVERVIEW: Semantic search for Swift and Markdown files

USAGE
  semly [-v|--version] [-h|--help] <subcommand> [options]
  Version: 1.0.2 (34)

SUBCOMMANDS (with brief help and options)
  version
    Print CLI version

  list-projects
    List all indexed projects

  settings
    Show current app settings

  status
    Show project status and progress
    Options: --project <project>

  query
    Search for code (modes: locate, retrieve, explain)
    Options: --project <project> | --ext <ext> | --limit <n> | --preview-chars <n> |
             --mode <locate|retrieve|explain> | --parseable | --topK <n> |
             --boost-show | --boost-symbol | --factor <1.00..1.15> | --lexical-prefilter

  explain
    Retrieve context and ask a model to explain (requires OPENAI_API_KEY)
    Options: --project <project> | --ext <ext> | --limit <n>

  add
    Add a project or add a folder to an existing project
    Options: <folder> | --project <project> | --name <new-project>

  remove
    Remove a project (stops analysis first)
    Options: --project <project> | --delete-data

  clean
    Clean derived index data for a project
    Options: --project <project>

  reindex
    Reindex a project (optionally with a specific model)
    Options: --project <project> | --model <id>

  model list
    List available embedding models

  model set <id>
    Set default embedding model

  symbols stats
    Show symbol counts by kind
    Options: --project <project>

  symbols rebuild
    Rebuild symbols table (optionally show stats)
    Options: --project <project> | --show-stats

  debug locate-logs <on|off>
    Toggle extra locate logs

  set concurrency <value>
    Set concurrent embedding requests (1..8)

  mcp
    Start MCP server

TYPICAL COMMANDS
  semly list-projects
  semly query "mergeLeadingImportChunkIfPresent" --project Semly --mode locate --ext swift --limit 5
  semly query "Where are embeddings generated and stored?" --project Semly --mode explain
  semly query "FileTracker change scanning" --project Semly --mode retrieve --ext swift,md
  semly symbols stats --project Semly
  semly reindex --project Semly --model <id>
  semly debug locate-logs on
  semly set concurrency 4
  semly mcp