Commands¶
Core¶
fcontext init¶
Initialize .fcontext/ in current directory. Creates _README.md and _workspace.map.
fcontext enable <agent>¶
Generate agent-specific instruction files pointing to .fcontext/.
fcontext enable copilot # .github/instructions/fcontext.instructions.md
fcontext enable claude # .claude/rules/fcontext.md
fcontext enable cursor # .cursor/rules/fcontext.md
fcontext enable trae # .trae/rules/fcontext.md
fcontext enable opencode # Claude format
fcontext enable openclaw # skills/ only
fcontext status¶
Show initialization state, enabled agents, indexed files, and experience packs.
fcontext version¶
Print version number.
Indexing¶
fcontext index <path>¶
Convert files or directories to Markdown. Supports PDF, DOCX, XLSX, PPTX, and more. Text files (.md, .txt, .rst) are copied directly.
fcontext index report.pdf # Single file
fcontext index docs/ # Entire directory
fcontext index specs/ --force # Re-convert even if cached
Requirements¶
fcontext req add <title>¶
Create a new requirement.
fcontext req add "User login" -t story
fcontext req add "Fix crash on submit" -t bug
fcontext req add "OAuth support" -t task --parent STORY-001
Types: roadmap, epic, story, task, bug
fcontext req list¶
List all requirements.
fcontext req show <id>¶
Show full details of a requirement.
fcontext req set <id> <field> <value>¶
Update a requirement field.
fcontext req set STORY-001 status in-progress
fcontext req set STORY-001 status done
fcontext req set STORY-001 priority high
fcontext req link <id> <relation> <target>¶
Link two requirements with an evolution relationship.
fcontext req trace <id>¶
Show the full evolution chain of a requirement.
fcontext req tree¶
Display requirements as a hierarchy tree.
fcontext req board¶
Display requirements as a Kanban board.
Topics¶
fcontext topic list¶
List all topic files with timestamps.
Topics are plain Markdown files in .fcontext/_topics/. AI agents create them during sessions to persist knowledge. You can also create them manually.
Experience Packs¶
fcontext experience list¶
List imported experience packs.
fcontext experience import <source>¶
Import a knowledge pack from zip, directory, URL, or Git repository.
fcontext experience import knowledge.zip
fcontext experience import /path/to/pack/
fcontext experience import git@github.com:org/pack.git
fcontext experience import https://example.com/pack.zip
fcontext experience update¶
Update all Git-sourced experience packs to latest.
fcontext experience remove <name>¶
Remove an imported experience pack.
Export¶
fcontext export <destination>¶
Export .fcontext/ data as a shareable package.