ComfyUI Node: Claude Memory Builder

Claude Memory Builder:

ClaudeCodeMemory is a specialized node designed to create and manage memory or context for Claude Code commands, facilitating the construction of CLAUDE.md-style memory from various sources. This node is particularly beneficial for users who need to aggregate and organize different types of memory inputs, such as text, files, and specific markdown content, into a cohesive memory structure. By leveraging this node, you can efficiently build a comprehensive memory context that can be utilized in subsequent Claude Code executions, enhancing the overall functionality and adaptability of your AI-driven projects. The node's primary function is to gather and compile memory data from multiple sources, ensuring that the resulting memory is both comprehensive and easily accessible for further processing.

Claude Memory Builder Input Parameters:

memory_type

The memory_type parameter specifies the source of the memory to be built. It determines how the node will gather and compile memory data. Options include "text" for direct text input, "memory_file" for selecting a pre-existing memory file, "file" for reading from a specified file path, "claude_md" for using Claude markdown content, and "combined" for aggregating all available sources. This parameter is crucial as it dictates the method of memory construction, impacting the final memory output.

memory_file

The memory_file parameter allows you to select a specific memory file from the available options in the memories directory. By default, it is set to "[Custom Memory]", which indicates that custom text input will be used if no file is selected. This parameter is essential when the memory_type is set to "memory_file", as it directs the node to the appropriate file for memory extraction.

text_memory

The text_memory parameter is used to input custom text directly into the memory construction process. This parameter is particularly useful when you want to include specific textual information that is not available in existing files or markdown content. It plays a significant role when the memory_type is "text" or when custom memory input is required.

file_path

The file_path parameter specifies the path to a file from which memory content will be read. This parameter is vital when the memory_type is set to "file", as it directs the node to the exact location of the file to be processed. Providing a valid file path ensures that the node can access and incorporate the file's content into the memory structure.

claude_md_content

The claude_md_content parameter allows you to input specific Claude markdown content directly into the memory. This parameter is used when the memory_type is "claude_md" or "combined", enabling the inclusion of structured markdown data into the memory context. It is particularly useful for integrating pre-formatted content that follows the CLAUDE.md style.

append_to

The append_to parameter provides an option to append the newly constructed memory to an existing memory string. This parameter is beneficial when you want to build upon or extend a previously created memory context, ensuring continuity and coherence in memory usage across different Claude Code executions.

Claude Memory Builder Output Parameters:

memory

The memory output parameter represents the final constructed memory as a string. This output is crucial as it encapsulates all the gathered and compiled memory data from the specified sources, ready for use in subsequent Claude Code operations. The memory output ensures that all relevant context and information are readily available for further processing.

memory (custom type)

The memory output is also returned as a custom type, ensuring compatibility with other nodes and processes within the Claude Code framework. This dual output format allows for seamless integration and utilization of the constructed memory in various AI-driven tasks, enhancing the flexibility and adaptability of your projects.

Claude Memory Builder Usage Tips:

• Ensure that the memory_type parameter is correctly set to match the source of memory you intend to use, as this will significantly impact the memory construction process.
• When using the file_path parameter, double-check that the path is correct and that the file exists to avoid errors during memory compilation.
• Utilize the append_to parameter to build upon existing memory contexts, allowing for a more comprehensive and continuous memory structure across different executions.

Claude Memory Builder Common Errors and Solutions:

Error: File not found: <file_path>

• Explanation: This error occurs when the specified file path does not exist or is incorrect.
• Solution: Verify the file path for accuracy and ensure that the file is present at the specified location.

Error reading file <file_path>: <error_message>

• Explanation: An error occurred while attempting to read the specified file, possibly due to file permissions or encoding issues.
• Solution: Check the file permissions and ensure it is accessible. Also, verify that the file is encoded in a compatible format, such as UTF-8.

Error: Memory file not found: <memory_file>

• Explanation: The selected memory file does not exist in the memories directory.
• Solution: Confirm that the memory file is present in the designated directory and that the file name is correctly specified.