id       = "picoclaw"
name     = "PicoClaw"
homepage = "https://picoclaw.io/"
description = "An ultra-efficient personal AI assistant."
executables   = ["picoclaw"]

[dotfiles]

# PicoClaw's official configuration guide documents ~/.picoclaw/config.json;
# its security guide documents the adjacent .security.yml file. The default
# workspace is persistent agent state and is excluded rather than synced as
# configuration.
# https://github.com/sipeed/picoclaw/blob/main/docs/guides/configuration.md
# https://github.com/sipeed/picoclaw/blob/main/docs/security/security_configuration.md
paths = ["~/.picoclaw/config.json"]
exclude = ["~/.picoclaw/workspace/"]
secret  = ["~/.picoclaw/.security.yml"]

[commands]
format = 1
label = "Ask the agent"
description = "Send one message to the PicoClaw agent, or start an interactive chat when no message is given."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["agent"]
label = "Chat with the agent"

[[commands.subcommand.source]]
id = "readme"
kind = "help"
url = "https://raw.githubusercontent.com/sipeed/picoclaw/HEAD/README.md"
revision = "2026-10-27"
evidence = """
picoclaw agent -m "What is 2+2?"
# Interactive mode
picoclaw agent
| `picoclaw agent -m "..."` | Chat with the agent              |
"""

[[commands.subcommand.field]]
id = "message"
label = "Message"
description = "Leave empty for interactive mode."
type = "string"
option = ["-m"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "ask"
label = "Ask once"
fields = ["message"]
required = ["message"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["message"]