orke employee save-document
Save a goal, draft, or memory document using its observed revision. Edit definitions with setting and rename commands. Changed files are rejected. Accepts raw UTF-8 through --stdin.
When to use it
Save a goal, draft, or memory document using its observed revision. Edit definitions with setting and rename commands. Changed files are rejected. Accepts raw UTF-8 through --stdin.
Syntax
Terminal
orke employee save-document --slug <string> --file <definition|goal|goal-draft|status|plan|learned|journal> [--date <string>] --text <string> --expectedRevision <string> [--stdin] [--json]Options
| Option | Required | Values and meaning |
|---|---|---|
--slug | Required | Folder slug from a preceding list/readstring |
--file | Required | Employee document kind; journal requires datedefinition|goal|goal-draft|status|plan|learned|journal |
--date | Optional | Journal date in YYYY-MM-DD formatstring |
--text | Required | Exact text to send or save; --stdin is available where shownstring |
--expectedRevision | Required | Definition revision from a preceding read; detects concurrent editsstring |
--stdin | Optional | Read strict UTF-8 input through standard input. |
Read common options and errors →
Role and constraints
operator · windows, macos, linux
- Requires a running daemon owned by the same OS user; --help never connects.
- Use exactly one of --text or --stdin. Strict UTF-8, at most 1048576 bytes; input is preserved exactly.
- Use expectedRevision from the preceding read; concurrent edits are rejected rather than overwritten.
Examples
Terminal
orke employee save-document --slug employee-slug --file goal --expectedRevision observed-revision --stdin --jsonReplace example IDs, slugs, revisions, and files with actual observations and inputs.
Response and partial results
EmployeeDocument: slug/file/date/text/revision/readState/truncated