Skip to main content

Coordinate

Ask another project for something and answer what is asked of you.

note

This page is generated from the CLI's argument parsers. Do not edit it: change the flag or its help text in the code, then run UPDATE_DOCS_REFERENCE=1 uv run pytest tests/test_docs_generated.py from plugin/.

See also: Ask another project, Decide and ratify, Requests and decisions.

daimon request​

ask another project for something, and answer what it asks (#694)

daimon request <command>
commandwhat it does
openopen a request addressed to another project's slug
reviseanswer a needs-info or sharpen an open ask; capped at 3 revisions per record
withdrawtake back a request this project sent; an agent may, because it is the sender's own ask and not a verdict. Final for that record: open a new one with --supersedes
severitychange how much a request you sent matters to you; an agent may. It moves no state and re-sends nothing: the new level shows on the recipient's next brief, inbox and decide. It is not --blocking
acceptaccept an addressed request; a human decision, or an agent under a ruling that covers its sender
rejectreject it with a reason; rejection is final for that record, and the sender can open a new one citing it
needs-infoask the sender for more before deciding
suppressdrop it out of the briefing panel; it stays in request list, and any later verdict reverses it
donereport the ask as satisfied; an agent claim renders as claimed-and-unverified until the byte-check
replysend the sender a progress note on a request you accepted; it moves no state, and the request stays owed until done
listlist this project's requests, undecided first
inboxrequests addressed TO this project, from every sender, undecided first

Examples

daimon request open --to ~/code/api --ask 'publish the 0.32 schema' --why 'the client cannot ship without it' --by agent
daimon request list
daimon request accept q-9c24d7

daimon request open​

open a request addressed to another project's slug

daimon request open --to PROJECT --ask ASK --why WHY [--title TITLE] [--to-human] [--kind info|work] [--blocking] [--severity critical|high|normal|low] [--severity-reason REASON] [--evidence EVIDENCE] [--supersedes REQUEST_ID] [--anyway] [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
--toPROJECTrecipient project directory, or its slug written as --to=<slug> (a slug starts with '-', which a bare --to would read as an option); daimon projects lists both (required)
--askASKwhat you are asking that project to do (required)
--whyWHYwhy it matters; the recipient reads this first (required)
--titleTITLEoptional headline of a few words (80 characters at most) that leads wherever the request is listed; the ask stays the full text
--to-humanthe ask is for that project's human, not its agent
--kindinfo|workworkapproval requirement: work (default) waits on a person, info is answerable from the recipient's own artifacts; only a human channel may open one as info
--blockingmark the sender as blocked on it; a flag on the record, never a claim on the recipient's time
--severitycritical|high|normal|lownormalhow much the outcome matters to you, which is not --blocking (whether you are stalled): the recipient's lists sort by it. Any level but the default needs --severity-reason
--severity-reasonREASONone line, 80 characters at most (refused past that, never cut), shown with the level; required with every level but the default
--evidenceEVIDENCEoptional source backing the ask; recorded, never resolved
--supersedesREQUEST_IDthe earlier q-… this ask replaces; the lineage renders always
--anywayrecord the ask even when the recipient slug has no bucket yet; it is never surfaced there until that project serializes
--byagentdeclare yourself an agent; omit it only from an interactive terminal, which is the human path
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request revise​

answer a needs-info or sharpen an open ask; capped at 3 revisions per record

daimon request revise request_id [--ask ASK] [--why WHY] [--evidence EVIDENCE] [--title TITLE] [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
request_idexact q-… id
--askASKreplacement ask
--whyWHYreplacement rationale
--evidenceEVIDENCEreplacement source
--titleTITLEreplacement title; --title '' removes it, and leaving it out keeps the current one
--byagentdeclare yourself an agent; omit it only from an interactive terminal
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request withdraw​

take back a request this project sent; an agent may, because it is the sender's own ask and not a verdict. Final for that record: open a new one with --supersedes

daimon request withdraw request_id --reason REASON [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
request_idexact q-… id
--reasonREASONwhy the ask no longer stands; the recipient reads it (required)
--byagentdeclare yourself an agent; omit it only from an interactive terminal
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request severity​

change how much a request you sent matters to you; an agent may. It moves no state and re-sends nothing: the new level shows on the recipient's next brief, inbox and decide. It is not --blocking

daimon request severity request_id critical|high|normal|low [--reason REASON] [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
request_idexact q-… id
`criticalhighnormallow`
--reasonREASONone line, 80 characters at most, shown with the level; required with every level but the default
--byagentdeclare yourself an agent; omit it only from an interactive terminal
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request accept​

accept an addressed request; a human decision, or an agent under a ruling that covers its sender

daimon request accept request_id [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
request_idexact q-… id
--noteNOTEkept on the record
--byagentdeclare yourself an agent; permitted only for an addressed ask (info or work) an active ruling of this project covers for its sender; otherwise it needs daimon request accept from a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon request reject​

reject it with a reason; rejection is final for that record, and the sender can open a new one citing it

daimon request reject request_id [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
request_idexact q-… id
--noteNOTEkept on the record
--byagentdeclare yourself an agent; the call then refuses, because this verb requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon request needs-info​

ask the sender for more before deciding

daimon request needs-info request_id [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
request_idexact q-… id
--noteNOTEkept on the record
--byagentdeclare yourself an agent; the call then refuses, because this verb requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon request suppress​

drop it out of the briefing panel; it stays in request list, and any later verdict reverses it

daimon request suppress request_id [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
request_idexact q-… id
--noteNOTEkept on the record
--byagentdeclare yourself an agent; the call then refuses, because this verb requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon request done​

report the ask as satisfied; an agent claim renders as claimed-and-unverified until the byte-check

An agent may run this on an accepted ask without asking the human.

daimon request done request_id --evidence EVIDENCE [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
request_idexact q-… id
--evidenceEVIDENCEwhat settles it; a verbatim quote from an agent is byte-checked at session end (required)
--byagentdeclare yourself an agent; omit it only from an interactive terminal
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request reply​

send the sender a progress note on a request you accepted; it moves no state, and the request stays owed until done

daimon request reply request_id --note NOTE [--evidence EVIDENCE] [--by agent] [--project PROJECT]
argumentvaluedefaultdescription
request_idexact q-… id
--noteNOTEthe update the sender reads; 2000 characters (required)
--evidenceEVIDENCEoptional pointer to what backs the update
--byagentdeclare yourself an agent; omit it only from an interactive terminal. An agent reply reaches the sender labeled unverified
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request list​

list this project's requests, undecided first

daimon request list [--json] [--min-severity critical|high|normal|low] [--project PROJECT]
argumentvaluedefaultdescription
--jsonmachine-readable output
--min-severitycritical|high|normal|lowonly requests at this severity or a more severe one
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon request inbox​

requests addressed TO this project, from every sender, undecided first

daimon request inbox [--json] [--min-severity critical|high|normal|low] [--project PROJECT]
argumentvaluedefaultdescription
--jsonmachine-readable output
--min-severitycritical|high|normal|lowonly requests at this severity or a more severe one
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon decide​

list what is waiting on YOU with the command that closes each (#766): the human-side mirror of daimon loops

daimon decide [--project PROJECT] [--all-projects]
argumentvaluedefaultdescription
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--all-projectsalso list every other project's queue as text, composed per project, each command routed with --slug=<slug> so it runs from here; refused on a tenant-scoped home (#766, #899)

Examples

daimon decide
daimon decide --project .