Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

cdno portfolio

Manage evidence portfolios: create, list, show, and link to a question or project. Filing evidence into a portfolio is the separate cdno file verb.

cdno portfolio [OPTIONS] <COMMAND>

Subcommands

SubcommandDescription
createCreate a portfolio under portfolios/<slug>/
listList portfolios with evidence counts + staleness
showShow a portfolio’s frontmatter + evidence inventory
linkLink an existing portfolio to a question or project

create/link honour --json ({path, message}); list/show emit their data under --json.


cdno portfolio create

Create a new portfolio. The slug derives from the question.

FlagDescription
--question <QUESTION>The question this dossier accumulates evidence for.
--project <PROJECT>Optional wikilink to a project to associate it with.
--var <NAME=VALUE>Value for a custom template’s prompted variable ([variables.prompt]). Repeatable. See Prompted variables.
cdno portfolio create --question "Sparse vs dense attention OOD"
cdno portfolio create --question "Sparse vs dense attention OOD" --project projects/surrogate-model

cdno portfolio list

List every portfolio with its evidence count and staleness. Honours --json.

cdno portfolio list
cdno portfolio list --json | jq '.[] | {slug, evidence_count}'

cdno portfolio show

Show a portfolio’s frontmatter and its evidence inventory. Honours --json (a detail object with the evidence list).

FlagDescription
--portfolio <PORTFOLIO>Portfolio slug.
cdno portfolio show --portfolio sparse-vs-dense-attention-ood
cdno portfolio show --portfolio sparse-vs-dense-attention-ood --json

Link an existing portfolio to an existing question or project (the retrofit path — pass exactly one of --question/--project). Backlinks are set on both sides.

FlagDescription
--portfolio <PORTFOLIO>Portfolio slug.
--question <QUESTION>Question to link (mutually exclusive with --project).
--project <PROJECT>Project wikilink to link (mutually exclusive with --question).
cdno portfolio link --portfolio sparse-vs-dense-attention-ood --project projects/surrogate-model
cdno portfolio link --portfolio sparse-vs-dense-attention-ood --question questions/research/surrogate-cost

create_portfolio, get_portfolio_contents (show), link_portfolio_to_question, link_portfolio_to_project.

See also