id          = "bkmr"
name        = "bkmr"
homepage    = "https://github.com/sysid/bkmr"
description = "Unified CLI tool for bookmarks, snippets, and knowledge management."
executables      = ["bkmr"]

[dotfiles]

# bkmr's official README documents generating this user configuration file.
# https://github.com/sysid/bkmr#initial-setup
paths = ["[configHome]/bkmr/config.toml"]

exclude = []
secret  = []

[commands]
format = 1
label = "bkmr"
description = "Add and search bookmarks and snippets. Only flags shown in the README examples are covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["add"]
label = "Add a bookmark or snippet"
description = "Store a URL or text with comma-separated tags."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/sysid/bkmr/blob/main/README.md"
revision = "main 2026-10-27"
evidence = """
bkmr add https://example.com tag1,tag2
bkmr add "SELECT * FROM users" sql,_snip_ --title "User Query"
bkmr add "Prod DB on port 5433" fact,database --title "Prod DB config" -t mem --no-web
"""

[[commands.subcommand.field]]
id = "content"
label = "URL or text"
type = "string"
position = 0
min = 1
sources = ["readme"]

[[commands.subcommand.field]]
id = "tags"
label = "Tags (comma-separated)"
type = "string"
position = 1
sources = ["readme"]

[[commands.subcommand.field]]
id = "title"
label = "Title"
type = "string"
option = ["--title"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "no_web"
label = "Don't fetch page metadata"
type = "boolean"
option = ["--no-web"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "add"
label = "Add"
fields = ["content", "tags", "title"]
required = ["content"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["content", "tags", "title", "no_web"]

[[commands.subcommand]]
path = ["search"]
label = "Search bookmarks"
description = "Search stored bookmarks, optionally in the fuzzy finder."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/sysid/bkmr/blob/main/README.md"
revision = "main 2026-10-27"
evidence = """
bkmr search github
bkmr search --fzf
"""

[[commands.subcommand.field]]
id = "query"
label = "Query"
type = "string"
position = 0
sources = ["readme"]

[[commands.subcommand.field]]
id = "fzf"
label = "Use fzf"
type = "boolean"
option = ["--fzf"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "search"
label = "Search"
fields = ["query", "fzf"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["query", "fzf"]