cecli-dev 0.95.5__py3-none-any.whl

cecli/website/docs/config/editor.md

@@ -0,0 +1,127 @@
+---
+parent: Configuration
+nav_order: 100
+description: How to configure a custom editor for aider's /editor command
+---
+
+# Editor configuration
+
+Aider allows you to configure your preferred text editor for use with the `/editor` command. The editor must be capable of running in "blocking mode", meaning the command line will wait until you close the editor before proceeding.
+
+## Using `--editor`
+
+You can specify the text editor with the `--editor` switch or using
+`editor:` in aider's
+[YAML config file](https://aider.chat/docs/config/aider_conf.html).
+
+## Environment variables
+
+Aider checks the following environment variables in order to determine which editor to use:
+
+1. `CECLI_EDITOR`
+2. `VISUAL`
+3. `EDITOR`
+
+## Default behavior
+
+If no editor is configured, aider will use these platform-specific defaults:
+
+- Windows: `notepad`
+- macOS: `vim`
+- Linux/Unix: `vi`
+
+## Using a custom editor
+
+You can set your preferred editor in your shell's configuration file (e.g., `.bashrc`, `.zshrc`):
+
+```bash
+export CECLI_EDITOR=vim
+```
+
+## Popular Editors by Platform
+
+### macOS
+
+1. **vim**
+   ```bash
+   export CECLI_EDITOR=vim
+   ```
+
+2. **Emacs**
+   ```bash
+   export CECLI_EDITOR=emacs
+   ```
+
+3. **VSCode**
+   ```bash
+   export CECLI_EDITOR="code --wait"
+   ```
+
+4. **Sublime Text**
+   ```bash
+   export CECLI_EDITOR="subl --wait"
+   ```
+
+5. **BBEdit**
+   ```bash
+   export CECLI_EDITOR="bbedit --wait"
+   ```
+
+### Linux
+
+1. **vim**
+   ```bash
+   export CECLI_EDITOR=vim
+   ```
+
+2. **Emacs**
+   ```bash
+   export CECLI_EDITOR=emacs
+   ```
+
+3. **nano**
+   ```bash
+   export CECLI_EDITOR=nano
+   ```
+
+4. **VSCode**
+   ```bash
+   export CECLI_EDITOR="code --wait"
+   ```
+
+5. **Sublime Text**
+   ```bash
+   export CECLI_EDITOR="subl --wait"
+   ```
+
+### Windows
+
+1. **Notepad**
+   ```bat
+   set CECLI_EDITOR=notepad
+   ```
+
+2. **VSCode**
+   ```bat
+   set CECLI_EDITOR="code --wait"
+   ```
+
+3. **Notepad++**
+   ```bat
+   set CECLI_EDITOR="notepad++ -multiInst -notabbar -nosession -noPlugin -waitForClose"
+   ```
+
+## Editor command arguments
+
+Some editors require specific command-line arguments to operate in blocking mode. The `--wait` flag (or equivalent) is commonly used to make the editor block until the file is closed.
+
+## Troubleshooting
+
+If you encounter issues with your editor not blocking (returning to the prompt immediately), verify that:
+
+1. Your editor supports blocking mode
+2. You've included the necessary command-line arguments for blocking mode
+3. The editor command is properly quoted if it contains spaces or special characters, e.g.:
+   ```bash
+   export CECLI_EDITOR="code --wait"
+   ```

cecli/website/docs/config/mcp.md

@@ -0,0 +1,210 @@
+---
+parent: Configuration
+nav_order: 120
+description: Configure Model Control Protocol (MCP) servers for enhanced AI capabilities.
+---
+
+# Model Control Protocol (MCP)
+
+Model Control Protocol (MCP) servers extend aider's capabilities by providing additional tools and functionality to the AI models. MCP servers can add features like git operations, context retrieval, and other specialized tools.
+
+## Configuring MCP Servers
+
+Aider supports configuring MCP servers using the MCP Server Configuration schema. Please
+see the [Model Context Protocol documentation](https://modelcontextprotocol.io/introduction)
+for more information.
+
+You have two ways of sharing your MCP server configuration with Aider.
+
+{: .note }
+
+> Today, CECLI/Cecli supports connecting to MCP servers using stdio, http, and sse transports.
+
+### Config Files
+
+You can configure MCP servers in your `.aider.conf.yml` file using either JSON or YAML format:
+
+#### JSON Configuration
+
+```yaml
+mcp-servers: |
+  {
+    "mcpServers": {
+      "git": {
+        "transport": "http",
+        "url": "http://localhost:8000"
+      }
+    }
+  }
+```
+
+#### YAML Configuration
+
+```yaml
+mcp-servers:
+  mcpServers:
+    context7:
+      transport: http
+      url: https://mcp.context7.com/mcp
+    deepwiki:
+      transport: http
+      url: https://mcp.deepwiki.com/mcp
+```
+
+Or specify a configuration file:
+
+```yaml
+mcp-servers-file: /path/to/mcp.json
+```
+
+These options are configurable in any of Aider's config file formats.
+
+### Flags
+
+You can specify MCP servers directly on the command line using the `--mcp-servers` option with a JSON or YAML string:
+
+#### Using a JSON String
+
+```bash
+aider --mcp-servers '{"mcpServers":{"git":{"transport":"http","url":"http://localhost:8000"}}}'
+```
+
+#### Using a YAML String
+
+```bash
+aider --mcp-servers 'mcpServers:
+  context7:
+    transport: http
+    url: https://mcp.context7.com/mcp
+  deepwiki:
+    transport: http
+    url: https://mcp.deepwiki.com/mcp'
+```
+
+#### Using a configuration file
+
+Alternatively, you can store your MCP server configurations in a JSON or YAML file and reference it with the `--mcp-servers-file` option:
+
+```bash
+aider --mcp-servers-file mcp.json
+```
+
+#### Specifying the transport
+
+You can use the `--mcp-transport` flag to specify the transport for all configured MCP servers that do not have a transport specified.
+
+```bash
+aider --mcp-transport http
+```
+
+### Environment Variables
+
+You can also configure MCP servers using environment variables in your `.env` file using JSON or YAML format:
+
+```
+CECLI_MCP_SERVERS={"mcpServers":{"git":{"transport": "stdio", "command":"uvx","args":["mcp-server-git"]}}}
+```
+
+Or specify a configuration file:
+
+```
+CECLI_MCP_SERVERS_FILE=/path/to/mcp.json
+```
+
+## Troubleshooting
+
+If you encounter issues with MCP servers:
+
+1. Use the `--verbose` flag to see detailed information about MCP server loading
+2. Check that the specified executables are installed and available in your PATH
+3. Verify that your JSON or YAML configuration is valid
+
+For more information about specific MCP servers and their capabilities, refer to their respective documentation.
+
+## Common MCP Servers
+
+Here are some commonly used MCP servers that can enhance aider's capabilities:
+
+### Context7
+
+Context7 MCP provides up-to-date, version-specific documentation and code examples directly from the source into your LLM prompts, eliminating outdated information and hallucinations. It offers a streamlined integration experience with built-in caching mechanisms and is optimized for explorative agentic workflows.
+
+```yaml
+mcp-servers:
+  mcpServers:
+    context7:
+      transport: http
+      url: https://mcp.context7.com/mcp
+```
+
+### DeepWiki
+
+DeepWiki MCP is an unofficial server that crawls Deepwiki URLs, converts pages to Markdown, and returns them as a single document or a list. It features domain safety, HTML sanitization, and link rewriting to provide clean, structured documentation from Deepwiki repositories.
+
+```yaml
+mcp-servers:
+  mcpServers:
+    deepwiki:
+      transport: http
+      url: https://mcp.deepwiki.com/mcp
+```
+
+### Serena
+
+Serena MCP provides LSP support for the current project, offering code analysis, symbol navigation, and project-specific tooling. It runs as a local stdio server and provides context-aware development assistance directly within the IDE environment.
+
+```yaml
+mcp-servers:
+  mcpServers:
+    serena:
+      transport: stdio
+      command: uvx
+      args: [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena",
+        "start-mcp-server",
+        "--context",
+        "ide",
+        "--project",
+        "{project path}"
+      ]
+```
+
+### Chrome DevTools
+
+Chrome DevTools MCP provides browser automation and debugging capabilities through Chrome's DevTools Protocol, enabling web page interaction, network monitoring, and performance analysis. It connects to a running Chrome instance and offers tools for web development testing and automation. Note: the configuration below requires you to start chrome with remote debugging enabled before
+starting the coding agent.
+
+```yaml
+mcp-servers:
+  mcpServers:
+    chrome-devtools:
+      transport: stdio
+      command: npx
+      args: [
+        "chrome-devtools-mcp@latest",
+        "--browser-url",
+        "http://127.0.0.1:9222"
+      ]
+```
+
+### GitHub
+
+GitHub MCP provides access to GitHub repositories, issues, pull requests, and other GitHub resources. It enables AI models to interact with GitHub data, read repository contents, and perform various GitHub operations. The server runs in a Docker container and requires a GitHub Personal Access Token for authentication.
+
+```yaml
+mcp-servers:
+  mcpServers:
+    github:
+      transport: stdio
+      command: "docker"
+      args: [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "GITHUB_PERSONAL_ACCESS_TOKEN=<access_token>",     
+        "ghcr.io/github/github-mcp-server"
+      ]
+```

cecli/website/docs/config/model-aliases.md

@@ -0,0 +1,173 @@
+---
+parent: Configuration
+nav_order: 1000
+description: Assign convenient short names to models.
+---
+
+# Model Aliases
+
+Model aliases allow you to create shorthand names for models you frequently use. This is particularly useful for models with long names or when you want to standardize model usage across your team.
+
+## Command Line Usage
+
+You can define aliases when launching aider using the `--alias` option:
+
+```bash
+aider --alias "fast:gpt-5-mini" --alias "smart:o3-mini"
+```
+
+Multiple aliases can be defined by using the `--alias` option multiple times. Each alias definition should be in the format `alias:model-name`.
+
+## Configuration File
+
+Of course,
+you can also define aliases in your [`.aider.conf.yml` file](https://aider.chat/docs/config/aider_conf.html):
+
+```yaml
+alias:
+  - "fast:gpt-5-mini"
+  - "smart:o3-mini"
+  - "hacker:claude-3-sonnet-20240229"
+```
+
+## Using Aliases
+
+Once defined, you can use the alias instead of the full model name from the command line:
+
+```bash
+aider --model fast  # Uses gpt-5-mini
+aider --model smart  # Uses o3-mini
+```
+
+Or with the `/model` command in-chat:
+
+```
+Aider v0.75.3
+Main model: anthropic/claude-3-7-sonnet-20250219 with diff edit format, prompt cache, infinite output
+Weak model: claude-3-5-sonnet-20241022
+Git repo: .git with 406 files
+Repo-map: using 4096 tokens, files refresh
+─────────────────────────────────────────────────────────────────────────────────────────────────────
+> /model fast
+
+Aider v0.75.3
+Main model: gpt-5-mini with diff edit format
+─────────────────────────────────────────────────────────────────────────────────────────────────────
+diff> /model smart
+
+Aider v0.75.3
+Main model: o3-mini with diff edit format
+─────────────────────────────────────────────────────────────────────────────────────────────────────
+>
+```
+
+## Built-in Aliases
+
+Aider includes some built-in aliases for convenience:
+
+<!--[[[cog
+import cog
+from aider.models import MODEL_ALIASES
+
+for alias, model in sorted(MODEL_ALIASES.items()):
+    cog.outl(f"- `{alias}`: {model}")
+]]]-->
+- `3`: gpt-3.5-turbo
+- `35-turbo`: gpt-3.5-turbo
+- `35turbo`: gpt-3.5-turbo
+- `4`: gpt-4-0613
+- `4-turbo`: gpt-4-1106-preview
+- `4o`: gpt-4o
+- `5`: gpt-5
+- `deepseek`: deepseek/deepseek-chat
+- `flash`: gemini/gemini-2.5-flash
+- `flash-lite`: gemini/gemini-2.5-flash-lite
+- `gemini`: gemini/gemini-3-pro-preview
+- `gemini-2.5-pro`: gemini/gemini-2.5-pro
+- `gemini-3-pro-preview`: gemini/gemini-3-pro-preview
+- `gemini-exp`: gemini/gemini-2.5-pro-exp-03-25
+- `grok3`: xai/grok-3-beta
+- `haiku`: claude-3-5-haiku-20241022
+- `optimus`: openrouter/openrouter/optimus-alpha
+- `opus`: claude-opus-4-20250514
+- `quasar`: openrouter/openrouter/quasar-alpha
+- `r1`: deepseek/deepseek-reasoner
+- `sonnet`: anthropic/claude-sonnet-4-20250514
+<!--[[[end]]]-->
+
+## Advanced Model Settings
+
+CECLI/Cecli supports model names with colon-separated suffixes (e.g., `gpt-5:high`) that map to additional configuration parameters defined in the relevant config.yml file. This allows you to create named configurations for different use cases. These configurations map precisely to the LiteLLM `completion()` method parameters [here](https://docs.litellm.ai/docs/completion/input), though more are supported for specific models and providers.
+
+### Configuration File
+
+Add a structure like the following to your config.yml file or create a `.aider.model.overrides.yml` file (or specify a different file with `--model-overrides-file` if there are global defaults you want):
+
+```yaml
+model-overrides:
+  gpt-5:
+    high:  # Use with: --model gpt-5:high
+      temperature: 0.8
+      top_p: 0.9
+      extra_body:
+        reasoning_effort: high
+    low:   # Use with: --model gpt-5:low
+      temperature: 0.2
+      top_p: 0.5
+    creative:  # Use with: --model gpt-5:creative
+      temperature: 0.9
+      top_p: 0.95
+      frequency_penalty: 0.5
+
+  claude-4-5-sonnet:
+    fast:    # Use with: --model claude-3-5-sonnet:fast
+      temperature: 0.3
+    detailed: # Use with: --model claude-3-5-sonnet:detailed
+      temperature: 0.7
+      thinking_tokens: 4096
+```
+
+### Usage
+
+You can use these suffixes with any model argument:
+
+```bash
+# Main model with high reasoning effort (using file)
+aider --model gpt-5:high --model-overrides-file .aider.model.overrides.yml
+
+# Main model with high reasoning effort (using direct JSON/YAML)
+aider --model gpt-5:high --model-overrides '{"gpt-5": {"high": {"temperature": 0.8, "top_p": 0.9, "extra_body": {"reasoning_effort": "high"}}}}'
+
+# Different configurations for main and weak models
+aider --model claude-3-5-sonnet:detailed --weak-model claude-3-5-sonnet:fast
+
+# Editor model with creative settings
+aider --model gpt-5 --editor-model gpt-5:creative
+```
+
+### How It Works
+
+1. When you specify a model with a suffix (e.g., `gpt-5:high`), Aider splits it into the base model name (`gpt-5`) and suffix (`high`).
+2. It looks up the suffix in the overrides file for that model.
+3. The corresponding configuration parameters are applied to the model's API calls.
+4. The parameters are deep-merged into the model's existing settings, with overrides taking precedence.
+
+### Priority
+
+Model overrides work alongside aliases. For example, you can use:
+- `aider --model fast:high` (if `fast` is an alias for `gpt-5-mini`)
+- `aider --model sonnet:detailed` (if `sonnet` is an alias for `anthropic/claude-sonnet-4-20250514`)
+
+The suffix is applied after alias resolution.
+
+## Priority
+
+If the same alias is defined in multiple places, the priority is:
+
+1. Command line aliases (highest priority)
+2. Configuration file aliases
+3. Built-in aliases (lowest priority)
+
+This allows you to override built-in aliases with your own preferences.
+
+Model overrides with suffixes provide an additional layer of configuration that works alongside aliases, giving you fine-grained control over model parameters for different use cases.