chore: simplify config via cosmiconfig

Author: bhouston

README.md

@@ -35,20 +35,54 @@ mycoder "Implement a React component that displays a list of items"
 mycoder -f prompt.txt
 
 # Disable user prompts for fully automated sessions
-mycoder --enableUserPrompt false "Generate a basic Express.js server"
+mycoder --userPrompt false "Generate a basic Express.js server"
 # or using the alias
 mycoder --userPrompt false "Generate a basic Express.js server"
 
 # Disable user consent warning and version upgrade check for automated environments
 mycoder --userWarning false --upgradeCheck false "Generate a basic Express.js server"
 
-# Enable GitHub mode via CLI option (overrides config)
+# Enable GitHub mode via CLI option (overrides config file)
 mycoder --githubMode "Work with GitHub issues and PRs"
+```
 
-# Enable GitHub mode via config
-mycoder config set githubMode true
+## Configuration
+
+MyCoder is configured using a `mycoder.config.js` file in your project root, similar to ESLint and other modern JavaScript tools. This file exports a configuration object with your preferred settings.
+
+### Creating a Configuration File
+
+Create a `mycoder.config.js` file in your project root:
+
+```js
+// mycoder.config.js
+export default {
+  // GitHub integration
+  githubMode: true,
+  
+  // Browser settings
+  headless: true,
+  userSession: false,
+  pageFilter: 'none', // 'simple', 'none', or 'readability'
+  
+  // Model settings
+  provider: 'anthropic',
+  model: 'claude-3-7-sonnet-20250219',
+  maxTokens: 4096,
+  temperature: 0.7,
+  
+  // Custom settings
+  customPrompt: '',
+  profile: false,
+  tokenCache: true,
+  
+  // Ollama configuration (if using local models)
+  ollamaBaseUrl: 'http://localhost:11434',
+};
 ```
 
+CLI arguments will override settings in your configuration file.
+
 ### GitHub Comment Commands
 
 MyCoder can be triggered directly from GitHub issue comments using the flexible `/mycoder` command:

docs/tools/agent-tools.md

@@ -39,7 +39,7 @@ const { instanceId } = agentStart({
   projectContext: 'Context about the problem or environment',
   workingDirectory: '/path/to/working/directory', // optional
   relevantFilesDirectories: 'src/**/*.ts', // optional
-  enableUserPrompt: false, // optional, default: false
+  userPrompt: false, // optional, default: false
 });
 ```
 

packages/agent/src/core/types.ts

@@ -20,7 +20,7 @@ export type ToolContext = {
   githubMode: boolean;
   customPrompt?: string;
   tokenCache?: boolean;
-  enableUserPrompt?: boolean;
+  userPrompt?: boolean;
   agentId?: string; // Unique identifier for the agent, used for background tool tracking
   provider: ModelProvider;
   model: string;

packages/agent/src/tools/getTools.ts

@@ -18,11 +18,11 @@ import { sleepTool } from './system/sleep.js';
 // Import these separately to avoid circular dependencies
 
 interface GetToolsOptions {
-  enableUserPrompt?: boolean;
+  userPrompt?: boolean;
 }
 
 export function getTools(options?: GetToolsOptions): Tool[] {
-  const enableUserPrompt = options?.enableUserPrompt !== false; // Default to true if not specified
+  const userPrompt = options?.userPrompt !== false; // Default to true if not specified
 
   // Force cast to Tool type to avoid TypeScript issues
   const tools: Tool[] = [
@@ -41,7 +41,7 @@ export function getTools(options?: GetToolsOptions): Tool[] {
   ];
 
   // Only include userPrompt tool if enabled
-  if (enableUserPrompt) {
+  if (userPrompt) {
     tools.push(userPromptTool as unknown as Tool);
   }
 

packages/agent/src/tools/interaction/agentStart.ts

@@ -50,7 +50,7 @@ const parameterSchema = z.object({
     .string()
     .optional()
     .describe('A list of files, which may include ** or * wildcard characters'),
-  enableUserPrompt: z
+  userPrompt: z
     .boolean()
     .optional()
     .describe(
@@ -104,7 +104,7 @@ export const agentStartTool: Tool<Parameters, ReturnType> = {
       projectContext,
       workingDirectory,
       relevantFilesDirectories,
-      enableUserPrompt = false,
+      userPrompt = false,
     } = parameterSchema.parse(params);
 
     // Create an instance ID
@@ -127,7 +127,7 @@ export const agentStartTool: Tool<Parameters, ReturnType> = {
       .filter(Boolean)
       .join('\n');
 
-    const tools = getTools({ enableUserPrompt });
+    const tools = getTools({ userPrompt });
 
     // Store the agent state
     const agentState: AgentState = {

packages/agent/src/tools/interaction/subAgent.ts

@@ -104,7 +104,7 @@ export const subAgentTool: Tool<Parameters, ReturnType> = {
       .filter(Boolean)
       .join('\n');
 
-    const tools = getTools({ enableUserPrompt: false });
+    const tools = getTools({ userPrompt: false });
 
     // Update config if timeout is specified
     const config: AgentConfig = {

packages/cli/README.md

@@ -38,8 +38,8 @@ mycoder --userPrompt false "Generate a basic Express.js server"
 # Disable user consent warning and version upgrade check for automated environments
 mycoder --userWarning false --upgradeCheck false "Generate a basic Express.js server"
 
-# Enable GitHub mode
-mycoder config set githubMode true
+# Enable GitHub mode via CLI option (overrides config file)
+mycoder --githubMode true
 ```
 
 ## GitHub Mode
@@ -54,14 +54,34 @@ MyCoder includes a GitHub mode that enables the agent to work with GitHub issues
 
 To enable GitHub mode:
 
+1. Via CLI option (overrides config file):
 ```bash
-mycoder config set githubMode true
+mycoder --githubMode true
+```
+
+2. Via configuration file:
+```js
+// mycoder.config.js
+export default {
+  githubMode: true,
+  // other configuration options...
+};
 ```
 
 To disable GitHub mode:
 
+1. Via CLI option:
 ```bash
-mycoder config set githubMode false
+mycoder --githubMode false
+```
+
+2. Via configuration file:
+```js
+// mycoder.config.js
+export default {
+  githubMode: false,
+  // other configuration options...
+};
 ```
 
 Requirements for GitHub mode:
@@ -71,7 +91,9 @@ Requirements for GitHub mode:
 
 ## Configuration
 
-MyCoder uses a configuration file in your project directory. To create a default configuration file, run:
+MyCoder is configured using a `mycoder.config.js` file in your project root, similar to ESLint and other modern JavaScript tools. This file exports a configuration object with your preferred settings.
+
+To create a default configuration file, run:
 
 ```bash
 # Create a default configuration file
@@ -122,13 +144,23 @@ MyCoder will search for configuration in the following places (in order of prece
 
 NOTE: Anthropic Claude 3.7 works the best by far in our testing.
 
-MyCoder supports Anthropic, OpenAI, xAI/Grok, Mistral AI, and Ollama models. You can configure which model provider and model name to use with the following commands:
+MyCoder supports Anthropic, OpenAI, xAI/Grok, Mistral AI, and Ollama models. You can configure which model provider and model name to use either via CLI options or in your configuration file:
 
 ```bash
-# Use Anthropic models [These work the best at this time]
-mycoder config set provider anthropic
-mycoder config set model claude-3-7-sonnet-20250219  # or any other Anthropic model
+# Via CLI options (overrides config file)
+mycoder --provider anthropic --model claude-3-7-sonnet-20250219 "Your prompt here"
+```
+
+Or in your configuration file:
 
+```js
+// mycoder.config.js
+export default {
+  // Model settings
+  provider: 'anthropic',
+  model: 'claude-3-7-sonnet-20250219',  // or any other Anthropic model
+  // other configuration options...
+};
 ```
 
 ### Available Configuration Options
@@ -146,25 +178,34 @@ These options are available only as command-line parameters and are not stored i
 
 - `userWarning`: Skip user consent check for current session without saving consent (default: `true`)
 - `upgradeCheck`: Disable version upgrade check for automated/remote usage (default: `true`)
-- `userPrompt`/`enableUserPrompt`: Enable or disable the userPrompt tool (default: `true`)
-
-Example:
+- `userPrompt`: Enable or disable the userPrompt tool (default: `true`)
 
-```bash
-# Set browser to show UI
-mycoder config set headless false
+Example configuration in `mycoder.config.js`:
 
-# Use existing browser session
-mycoder config set userSession true
+```js
+// mycoder.config.js
+export default {
+  // Browser settings
+  headless: false,  // Show browser UI
+  userSession: true,  // Use existing browser session
+  pageFilter: 'readability',  // Use readability for webpage processing
+  
+  // Custom settings
+  customPrompt: "Always prioritize readability and simplicity in your code. Prefer TypeScript over JavaScript when possible.",
+  tokenCache: false,  // Disable token caching for LLM API calls
+  
+  // Other configuration options...
+};
+```
 
-# Use readability for webpage processing
-mycoder config set pageFilter readability
+You can also set these options via CLI arguments (which will override the config file):
 
-# Set custom instructions for the agent
-mycoder config set customPrompt "Always prioritize readability and simplicity in your code. Prefer TypeScript over JavaScript when possible."
+```bash
+# Set browser to show UI for this session only
+mycoder --headless false "Your prompt here"
 
-# Disable token caching for LLM API calls
-mycoder config set tokenCache false
+# Use existing browser session for this session only
+mycoder --userSession true "Your prompt here"
 ```
 
 ## Environment Variables