Skip to content

contox pull

Pull contexts from the Contox platform to local markdown files. This lets you review, edit, or version-control your project brain content locally.

Usage

bash
contox pull [options]

Options

FlagDescriptionRequiredDefault
-o, --out <dir>Output directory for the pulled filesNo. (current directory)
-p, --project <projectId>Override the project IDNofrom config

Examples

Pull all contexts to the current directory:

bash
contox pull

Pull to a specific directory:

bash
contox pull -o ./brain-export

Pull from a specific project:

bash
contox pull -p proj_abc123 -o ./other-project-brain

What it does

The command fetches all contexts from your project on the Contox platform and writes each one as a local markdown file in the specified output directory.

Notes

  • This is the inverse of contox push. Together, push and pull let you manage a two-way sync between local files and the platform.
  • Use contox status to see which contexts exist and their current state before pulling.
  • Pulled files can be edited locally and pushed back with contox push.