Parse is a command-line tool designed to assist developers with coding tasks using large language models (LLMs). It provides code suggestions, debugging help, and workflow automation, making it a versatile coding assistant.
As of July 23, 2025, Parse is in active development. Recent updates include enhanced LLM integration with a reason-and-act loop for iterative problem-solving, and full availability of file management tools to the LLM for dynamic task handling.
Completed: CLI REPL with readline; commands for file ops (/read, /write), help (/help), quit (/quit or /exit), and authentication (/login); API key validation and storage in ~/.parse/config.json; Comprehensive file tools (create, edit, list, find, rename, delete, tree, read) integrated with LLM.
In Progress: Advanced tool protocols for code execution and testing. The modular design ensures extensibility, with features like config management, file operations, and commands separated for easy maintenance.
- Reason-and-Act Loop: The prompt system now supports a ReAct-style loop, allowing the LLM to reason about tasks, invoke tools as needed, and iterate until resolution. This enables complex, multi-step interactions without manual intervention.
- LLM-Available Tools: Tools are fully integrated and callable by the LLM, including file creation, editing, reading, and directory management. This empowers automated workflows like code generation and debugging.
Parse explores LLMs for code assistance, emphasizing modularity and extensibility. This project is being written by Grok: 99% of the code is generated by Grok via prompts on grok.com or the xAI Grok API. The developer simply writes prompts, copy-pastes the artifacts, and makes minor tweaks.
- Node.js: For the CLI runtime.
- TypeScript: For type safety and maintainability.
- xAI API: For LLM integration (authentication implemented; full prompt handling forthcoming).
Incremental builds maintain a working system at each stage. Features are developed in small, testable units, with tests covering happy and error paths. See principles.md for guidelines like strict typing and failing hard with errors.
For next steps, see TODO.md.
Clone the repository:
git clone https://github.com/galileopy/parse.git
cd parseInstall dependencies:
npm installRun the application:
npm run devThis launches the CLI with a Parse > prompt. Available commands:
/read <path>: Read the file at the given path./write <path> <content>: Write content to the file./help [command|command|...]: Show help (e.g.,/help read|writefor specific commands or/helpfor all)./login <provider> <apiKey>: Save and validate authentication config (e.g., provider: xAI)./quitor/exit: Exit the application.
Non-command inputs are processed by the LLM with tool support. Authentication loads on startup; if missing or invalid, use /login to set it up.
Contributions are welcome! Review TODO.md for priorities, and submit issues or PRs on GitHub. Follow the modular structure and principles.md for new features.
GNU General Public License v3.0.
Code generated via grok.com or xAI Grok API.