Skip to main content
While session management (/session) saves the conversation history, context management (/context) saves the content of your working environment. It is the most powerful feature for those working on multiple projects or who frequently need to consult the same codebase. A Context is a named “snapshot” of one or more files and directories, processed and saved to disk for reuse at any time.

​
The Lifecycle of a Context

Context usage follows a simple and powerful flow:
1

Create (/context create)

You define a set of files and folders, process them with a specific mode (e.g., smart, chunked), and save the result with a name.
2

Attach (/context attach)

You “attach” one or more saved contexts to your current conversation session.
3

Use

While attached, the context content is automatically sent to the AI with all your prompts, providing deep and continuous knowledge about your project.
4

Detach (/context detach)

When you no longer need the context, you detach it to free up space in the AI prompt.

​
Context Management Commands

Here are all the available subcommands for managing your contexts.

​
create: Create a New Context

Creates and saves a new context from files and directories. Syntax: 
/context create <context-name> <path_1> [path_2...] [options]
Options:
FlagDescription
--mode <mode> or -mDefines how files will be processed. Modes: full, summary, chunked, or smart.
--description <text> or -dAdds a text description to help identify the context.
--tags <tag1,tag2> or -tAdds tags for easier filtering and organization.
--force or -fOverwrites an existing context with the same name.
Example: 
# Creates an 'api-core' context with smart mode, description, and tags
/context create api-core ./src/services ./docs/api \
  --mode smart \
  --description "Context with the API core and documentation" \
  --tags golang,api

​
attach and detach: Attach and Detach from Session

These commands control which contexts are active in your current conversation.
CommandDescription
/context attach <context-name>Attaches a context to the session.
/context detach <context-name>Removes a context from the session.
/context attachedLists all currently attached contexts.

​
Advanced Chunk Attachment

If a context was created with --mode=chunked, you can attach specific parts of it:
FlagDescription
--chunk <N>Attaches only chunk number N.
--chunks <N,M,...>Attaches a list of specific chunks.
--priority <num>Defines the order in which attached contexts are sent (lower number = higher priority).
Example: 
# Attaches only chunks 1 and 3 from the 'legado-db' context with high priority
/context attach legado-db --chunks 1,3 --priority 10

​
list, show, and inspect: View Contexts

These commands help you understand what is in your saved contexts.
CommandDescription
/context listLists all available contexts with basic metadata.
/context show <name>Displays detailed information about a context, including the complete list of files.
/context inspect <name>Provides a deep statistical analysis of the context, such as file type distribution, line counts, and chunk size analysis. Use --chunk N to inspect a specific chunk.

​
Other Management Commands

Permanently deletes a context.
Combines multiple contexts into a new one, removing duplicate files.
Exports a context to a JSON file, making backup and sharing easier.
Imports a context from a JSON file.
Shows global statistics about all your contexts (total count, size, etc.).
Displays a help screen specific to context commands.

​
Next Steps

You now know the most powerful automation and context management features of ChatCLI. To wrap up, let’s document the features that ensure portability and tool integration in scripts.

Non-Interactive Mode

Use ChatCLI in scripts, automations, and CI/CD pipelines.

Session Management

Save and restore complete conversation histories.