brief

Troubleshooting

brief: command not found

The binary may have been installed to ~/go/bin when GOBIN is unset.

export PATH="$HOME/go/bin:$PATH"

Verify:

which brief
brief --help

go: command not found

Go is not installed or not on PATH.

Verify:

which go
go version

brief delete requires --force in non-TTY contexts

This is expected. In non-interactive contexts, delete requires --force.

brief delete 12 --force

unknown category ...

Categories are fixed. Valid values are:

• note
• lesson
• decision
• preference
• workflow
• snippet

unknown config key ...

Config keys are fixed. Valid keys are:

• default_limit
• default_category

Empty Results

Empty search results are a normal success condition.

Examples:

brief get "query that does not exist"
brief get --recent --tag missing-tag

Deprecated Entries Not Showing Up

Deprecated entries are excluded by default.

Use:

brief get --id 12 --include-deprecated
brief get "query" --include-deprecated