contox push
Push local files as contexts to the Contox platform. Each file becomes a context in your project brain, making it available to AI assistants.
Usage
bash
contox push <files...> [options]
Arguments
| Argument | Description | Required |
|---|---|---|
files | One or more file paths to push as contexts | Yes |
Options
| Flag | Description | Required | Default |
|---|---|---|---|
-p, --project <projectId> | Override the project ID | No | from config |
-t, --team <teamId> | Override the team ID | No | from config |
Examples
Push a single file:
bash
contox push architecture.md
Push multiple files:
bash
contox push docs/api-spec.md docs/conventions.md docs/deployment.md
Push to a specific project:
bash
contox push notes.md -p proj_abc123
Push using glob patterns (shell expansion):
bash
contox push docs/*.md
What it does
For each file provided:
- Reads the file contents from disk
- Creates a context on the Contox platform using the file name and contents
- Associates the context with your project brain
This is useful for manually adding documentation, architecture notes, or any text content that should be part of your AI's project knowledge.
Notes
- Files are pushed as-is. No enrichment or transformation is applied during push.
- To pull contexts back to local files, use
contox pull. - To check the current state of contexts, use
contox status.