Skip to content
How things are organized

Session is the atom

Everything else attaches to it.

๐Ÿ’ฌ Sessionone conversationimmutable UUID๐Ÿ“ Projectauto ยท 1๐Ÿท๏ธ Tagmix ยท N ยท cross๐Ÿ“‚ Collectionmanual ยท tree๐Ÿงต Threadmix ยท DAG๐Ÿ“ Notemanual ยท 1โญ Pinmanual ยท โ˜…โœŽ Aliasmanual ยท 1

How each concept behaves

Same eight concepts, four properties each. Read across a row.

  • Sessionatom

    One conversation. Immutable UUID.

    Origin
    Auto
    Per session
    One per session
    Cross-project
    Not applicable
    Shape
    None
  • Project

    Derived from the working directory.

    Origin
    Auto
    Per session
    One per session
    Cross-project
    Not applicable
    Shape
    None
  • Alias

    Human-readable nickname for a session.

    Origin
    You create it
    Per session
    One per session
    Cross-project
    Not applicable
    Shape
    None
  • Tag

    Flat #keyword labels.

    Origin
    Auto or manual
    Per session
    Many per session
    Cross-project
    Yes
    Shape
    Flat
  • Collection

    Hand-picked tree, up to 8 deep.

    Origin
    You create it
    Per session
    Many per session
    Cross-project
    Yes
    Shape
    Tree (8 deep)
  • Thread

    DAG of sessions tied by intent.

    Origin
    Auto or manual
    Per session
    Many per session
    Cross-project
    Yes
    Shape
    DAG
  • Pin

    Floats a session to the top of its list.

    Origin
    You create it
    Per session
    One per session
    Cross-project
    Not applicable
    Shape
    Single star
  • Note

    Markdown attached to a session.

    Origin
    You create it
    Per session
    One per session
    Cross-project
    Not applicable
    Shape
    None

Decide in one glance

Which concept fits the moment?

If Same concept appears across many sessions?

Tag it

e.g. #auth ยท #migration ยท #bug-fix

If A handful of sessions for one milestone?

Make a Collection

e.g. v1.0 launch decisions

If One particular session to recall by name?

Alias and pin it

e.g. auth-middleware-refactor

If Several sessions form one unit of work?

Spin up a Thread

e.g. planning + execution children

How things are organized

The diagram above maps every concept onto the Session atom. The matrix:

ConceptAuto / manualPer-sessionCross-projectHierarchical
Projectauto from cwdoneโ€“no
Aliasmanualone (history kept)n/ano
Tagmanual or auto-scanmanyyesflat
Collectionmanualmanyyestree, max 8 deep
Threadmanual now, auto in v0.15bmanyyesDAG
Pinmanualone (boolean)n/ano
Notemanualone (history kept)n/ano

#Which one when

  • Same concept across projects โ†’ tag
  • Curated, nestable bundle โ†’ collection
  • One specific session you'll search for by memory โ†’ alias + pin
  • Connected unit of work (planning + execution) โ†’ thread

Last updated