cecli is yet another cli agent crafted for extensibility and customization. For folks who like seeing under the hood, welcome to the fold. Made for nerds, geeks, and the extremely curious.
Links
Documentation Discord Chat Issue Queue
Installation Instructions
All installation methods export a cecli command that can start the application. This project can be installed using several methods:
Linux & Mac
Use curl to download the script and execute it with sh:
curl -LsSf https://cecli.dev/install.sh | sh
If your system doesn't have curl, you can use wget:
wget -qO- https://cecli.dev/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://cecli.dev/install.ps1 | iex"
Package Installation
uv pip install --native-tls cecli-dev
or
pip install cecli-dev
Tool Installation
uv tool install --native-tls --python python3.12 cecli-dev
Use the tool installation so cecli doesn't interfere with your development environment
Features and Documentation:
- Agent Mode
- MCP Configuration
- Skills
- Subagents
- Persistent Memory
- Session Management
- Hooks
- TUI Configuration
- Agent Client Protocol (ACP)
- Workspaces
- Custom Commands
- Custom System Prompts
- Custom Tools
- Advanced Model Configuration
Project Roadmap/Goals
- Base Asynchronicity (cecli coroutine-experiment branch)
- Refactor codebase to have the main loop run asynchronously
- Update test harness to work with new asynchronous methods
- Repo Map Accuracy - Discussion
- Bias page ranking toward active/editable files in repo map parsing
- Include import information in repo map for richer context
- Handle non-unique symbols that break down in large codebases
- Context Discovery - Discussion - Done with Cymbal Library
- Develop AST-based search capabilities
- Enhance file search with ripgrep integration
- Implement RAG (Retrieval-Augmented Generation) for better code retrieval
- Build an explicit workflow and local tooling for internal discovery mechanisms
- Context Delivery - Discussion
- Use workflow for internal discovery to better target file snippets needed for specific tasks (ExploreCode and ReadRange)
- Add support for partial files and code snippets in model completion messages
- Update message request structure for optimal caching
- TUI Experience - Discussion
- Add a full TUI (probably using textual) to have a visual interface competitive with the other coding agent terminal programs
- Re-integrate pretty output formatting
- Implement a response area, a prompt area with current auto completion capabilities, and a helper area for managing utility commands
- Agent Mode - Discussion
- Renaming "navigator mode" to "agent mode" for simplicity
- Add an explicit "finished" internal tool
- Add a configuration json setting for agent mode to specify allowed local tools to use, tool call limits, etc.
- Make the system prompts more aggressive about removing unneeded files/content from the context
- Add a plugin-like system for allowing agent mode to use user-defined tools in simple python files
- Add a dynamic tool discovery tool to allow the system to have only the tools it needs in context
- Sub Agents
- Add
/invoke-agentcommand to manually branch a sub agent and return a summary to the main context - Add an instance-able view of the conversation system so sub agents get their own context and workspaces
- Modify coder classes to have discrete identifiers for themselves/management utilities for them to have their own slices of the world
- Refactor global files like todo lists to live inside instance folders to avoid state conflicts
- Add a
Delegatetool that launches a sub agent as a background command that the parent model waits for to finish - Add visibility into active sub agent calls in TUI
- Hooks
- Add hooks base class for user defined python hooks with an execute method with type and priority settings
- Add hook manager that can accept user defined files and command line commands
- Integrate hook manager with coder classes with hooks for
start,end,on_message,end_message,pre_tool, andpost_tool
- Efficient File Editing
- Explore use of hashline file representation for more targeted file editing
- Assuming viability, update SEARCH part of SEARCH/REPLACE with hashline identification (Done with new edit format)
- Update agent mode edit tools to work with hashline identification
- Update internal file diff representation to support hashline propagation
- Dynamic Context Management (Accomplished with subagents, orchestrate, and the facts db)
- Update compaction to use observational memory sub agent calls to generate decision records that are used as the compaction basis
- Persist decision records to disk for sessions with some settings for managing lifetimes of such persistence
- Integrate RLM-like facility to extract information from decision records on disk and other definable notes
- Add a "describe" tool that launches a sub agent workflow that populates an RLM call's context with:
- Current Conversation History
- Past Decision Records
- Repo Map Found Files
- Quality of Life
- Add hot keys support for running repeatable commands like switching between preferred models
- Unified error message logging inside of
.ceclidirectory
All Contributors (Both Cecli and Aider main)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cecli_dev-1.2.3.tar.gz
(2.2 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cecli_dev-1.2.3.tar.gz.
File metadata
- Download URL: cecli_dev-1.2.3.tar.gz
- Upload date:
- Size: 2.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
07c611cec01d9319ca01550d2ce2b675a6950cf869cc40858d5f3c3945d01e3d
|
|
| MD5 |
11f1d8ec6100c6beb8059f97df148a4c
|
|
| BLAKE2b-256 |
665365b62d326c162e393a38938e380f4bdd3f05e72445da2ab66bf535eac2bd
|
File details
Details for the file cecli_dev-1.2.3-py3-none-any.whl.
File metadata
- Download URL: cecli_dev-1.2.3-py3-none-any.whl
- Upload date:
- Size: 1.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8f3b4f0833c514f045ad2a507b4290ab59b3615826bb87e28a5ed13a01095e3c
|
|
| MD5 |
4e5d048d6d9d58a3f76d520566680f6a
|
|
| BLAKE2b-256 |
cc3a20ffe4fa2683aec8f25d5261663d118e225bc1ad2c784d4b320f5f3164a2
|
