keep move

Move versions from now (or another note) into a named note.

As you update keep now throughout a session, a string of versions accumulates. keep move extracts selected versions into a named note. Requires either -t (tag filter) or --only (cherry-pick the tip).

Usage

keep move "auth-string" -t project=myapp       # Move matching versions from now
keep move "auth-string" -t project=myapp       # Incremental: appends more
keep move "quick-note" --only                   # Move just the current version
keep move "target" --from "source" -t topic=X  # Reorganize between items

Options

Option	Description
`-t`, `--tag KEY=VALUE`	Only extract versions matching these tags (repeatable)
`--only`	Move only the current (tip) version
`--from ITEM_ID`	Source item to extract from (default: now)
`--analyze`	Queue background analysis after move (decompose into parts)
`-s`, `--store PATH`	Override store directory

Required: at least one of -t or --only must be specified.

How it works

Versions matching the filter are moved from the source to the named target
Non-matching versions remain in the source, with gaps tolerated
If the source is fully emptied and is now, it resets to default content
The moved item gets _saved_from and _saved_at system tags

Note on URI-shaped target names: The target name is just a string ID — it can be anything, including a URI like https://example.com/doc or file:///path/to/file. However, if the target name looks like a URI, a subsequent keep put <that-uri> will re-fetch content from the URL and overwrite what was moved there. This is by design (the ID is its fetch source), but be aware that move can effectively create an item whose ID points to a different origin than its content. This is analogous to a redirect — the stored content came from now, but the ID says https://....

Cherry-picking with --only

--only moves just the current (tip) version, one at a time. This is the cherry-picker for reorganizing untagged items:

keep move "string-a" --only          # Move tip to string-a
keep move "string-b" --only          # Move next tip to string-b
keep move "string-a" --only          # Append another to string-a

Combine with -t to only move the tip if it matches:

keep move "auth-log" --only -t topic=auth   # Move tip only if tagged auth

Reorganizing with --from

Use --from to extract versions from any item, not just now:

# Over-grabbed? Pull specific versions out
keep move "auth-string" --from "big-dump" -t project=auth
keep move "docs-string" --from "big-dump" -t project=docs

# Cherry-pick one version from an existing item
keep move "highlights" --from "session-log" --only

Incremental move

Moving to an existing name appends the new versions on top of the existing history:

# Session 1
keep now "design discussion" -t project=alpha
keep now "decided on approach B" -t project=alpha
keep move "alpha-log" -t project=alpha

# Session 2
keep now "implemented approach B" -t project=alpha
keep now "tests passing" -t project=alpha
keep move "alpha-log" -t project=alpha          # Appends to existing

keep get alpha-log --history                     # Shows all 4 versions

Tag-filtered move

When you work on multiple projects in one session, tag filtering lets you move each string separately:

keep now "auth: token refresh" -t project=auth
keep now "docs: update API guide" -t project=docs
keep now "auth: added tests" -t project=auth

keep move "auth-string" -t project=auth    # Extracts 2 auth versions
keep now                                    # Still has docs version

Version history

The moved item has full version history, navigable like any other item:

keep get string-name                 # Current (newest moved)
keep get string-name -V 1            # Previous version
keep get string-name --history       # List all versions