Configuration Overview

DevDaily uses a JSON configuration file to customize behavior, appearance, and integrations. Configuration supports both local (per-project) and global (user-wide) settings with JSON Schema support for IDE autocomplete.

Configuration File Locations

DevDaily searches for configuration files in the following order:

Scope	Path	Purpose
Local (per-project)	`.devdaily.json`	Project-specific settings
Global	`~/.config/devdaily/config.json`	User-wide defaults
Secrets	`~/.config/devdaily/secrets.json` or `.devdaily.secrets.json`	API tokens and webhook URLs

Local configuration overrides global configuration. Settings are merged, with local values taking precedence.

JSON Schema Support

Enable autocomplete and validation in your IDE by adding the $schema field:

.devdaily.json

{
  "$schema": "https://raw.githubusercontent.com/hempun10/devdaily/main/schemas/devdaily.schema.json",
  "version": 1
}

This provides:

IntelliSense/autocomplete in VS Code, JetBrains IDEs, and other editors
Inline documentation for all configuration options
Validation warnings for invalid values

Example Configuration

Here’s a complete example .devdaily.json file:

.devdaily.json

{
  "$schema": "https://raw.githubusercontent.com/hempun10/devdaily/main/schemas/devdaily.schema.json",
  "version": 1,
  
  "theme": {
    "primary": "blue",
    "success": "green",
    "warning": "yellow",
    "error": "red",
    "accent": "cyan",
    "muted": "gray"
  },
  
  "ascii": true,
  "animations": true,
  "compactMode": false,
  
  "aliases": {
    "standup": ["s", "su", "daily"],
    "pr": ["p", "pull"],
    "week": ["w", "weekly"],
    "dash": ["d", "dashboard"]
  },
  
  "output": {
    "format": "markdown",
    "copyToClipboard": true,
    "showStats": true,
    "verbose": false
  },
  
  "git": {
    "defaultBranch": "main",
    "excludeAuthors": [],
    "excludePatterns": ["merge commit", "Merge branch"]
  },
  
  "projects": [],
  
  "shortcuts": {
    "quit": "q",
    "help": "?",
    "refresh": "r",
    "copy": "c",
    "create": "enter",
    "back": "esc",
    "nextProject": "tab",
    "prevProject": "shift+tab"
  },
  
  "projectManagement": {
    "tool": "github",
    "jira": {
      "useApiToken": true
    },
    "linear": {
      "useApi": true
    },
    "notion": {
      "useApi": true
    }
  },
  
  "notifications": {
    "slack": {
      "enabled": false
    },
    "discord": {
      "enabled": false
    },
    "standupTimezone": "America/New_York"
  },
  
  "journal": {
    "autoSnapshot": true,
    "gitHooks": false,
    "quiet": true
  },
  
  "copilot": {
    "timeout": 30000,
    "retries": 2
  },
  
  "standup": {
    "defaultDays": 1,
    "includeWIP": false,
    "sections": ["completed", "in-progress", "blockers"],
    "groupBy": "none",
    "includeTicketLinks": true,
    "scheduleDays": ["monday", "tuesday", "wednesday", "thursday", "friday"]
  },
  
  "pr": {
    "defaultBase": "main",
    "autoLabels": true,
    "defaultLabels": [],
    "defaultReviewers": [],
    "defaultAssignees": [],
    "titleFormat": "conventional",
    "includeTicketInTitle": true,
    "includeDiff": true,
    "maxDiffLines": 200
  },
  
  "week": {
    "startDay": "monday",
    "includeWeekends": false
  }
}

Configuration Categories

Display Settings

object

Color theme for terminal output

Show properties

string

default:"blue"

Primary color for headings and highlights

string

default:"green"

Color for success messages

string

default:"yellow"

Color for warnings

string

default:"red"

Color for errors

string

default:"cyan"

Accent color for secondary elements

string

default:"gray"

Color for muted/dimmed text

boolean

default:"true"

Show ASCII art banners

boolean

default:"true"

Enable loading spinners and animations

boolean

default:"false"

Use compact output with less whitespace

Command Aliases

object

Custom command aliases for faster access

Show properties

string[]

default:"[\"s\", \"su\", \"daily\"]"

Aliases for standup command

string[]

default:"[\"p\", \"pull\"]"

Aliases for pr command

string[]

default:"[\"w\", \"weekly\"]"

Aliases for week command

string[]

default:"[\"d\", \"dashboard\"]"

Aliases for dash command

Output Preferences

object

Output formatting and behavior

Show properties

enum

default:"markdown"

Default output format: markdown, slack, plain, or json

boolean

default:"true"

Automatically copy output to clipboard

boolean

default:"true"

Show statistics (commit count, file changes, etc.)

boolean

default:"false"

Enable verbose logging

Git Settings

object

Git repository configuration

Show properties

string

default:"main"

Default branch name for comparisons

string[]

default:"[]"

Authors to exclude from analysis

string[]

default:"[\"merge commit\", \"Merge branch\"]"

Commit message patterns to exclude

Multi-Project Support

array

List of projects for cross-project summaries

"projects": [
  {
    "name": "frontend",
    "path": "/path/to/frontend",
    "defaultBranch": "main",
    "team": ["alice", "bob"]
  },
  {
    "name": "backend",
    "path": "/path/to/backend"
  }
]

string

Currently active project name

Keyboard Shortcuts

object

Keyboard shortcuts for interactive commands

Show properties

string

default:"q"

Quit/exit

string

default:"?"

Show help

string

default:"r"

Refresh data

string

default:"c"

Copy to clipboard

string

default:"enter"

Create/submit

string

default:"esc"

Go back

string

default:"tab"

Next project

string

default:"shift+tab"

Previous project

Journal / Auto-Snapshots

object

Work journal and auto-snapshot configuration. See Git Hooks for details.

Show properties

boolean

default:"true"

Automatically take snapshots when running commands

boolean

default:"false"

Install git hooks for automatic snapshots

boolean

default:"true"

Enable post-commit hook

boolean

default:"true"

Enable post-checkout hook

boolean

default:"true"

Suppress snapshot side-effect messages

number

default:"0"

Days before auto-pruning journal entries (0 = never)

AI/Copilot Settings

object

GitHub Copilot CLI configuration

Show properties

number

default:"30000"

Request timeout in milliseconds

number

default:"2"

Number of retry attempts on failure

Managing Configuration

View Current Configuration

devdaily config

Edit Configuration

devdaily config --edit        # Opens in $EDITOR
devdaily config --path        # Show config file path

Reset to Defaults

Delete the configuration file and run devdaily init:

rm .devdaily.json
devdaily init

Secrets Management

Sensitive values like API tokens and webhook URLs should be stored in a separate secrets file:

{
  "jira": {
    "email": "your@email.com",
    "apiToken": "your-jira-api-token",
    "baseUrl": "https://yourcompany.atlassian.net"
  },
  "linear": {
    "apiKey": "lin_api_..."
  },
  "notion": {
    "apiKey": "secret_...",
    "databaseId": "..."
  },
  "slack": {
    "webhookUrl": "https://hooks.slack.com/services/..."
  },
  "discord": {
    "webhookUrl": "https://discord.com/api/webhooks/..."
  }
}

{
  "slack": {
    "webhookUrl": "https://hooks.slack.com/services/..."
  }
}

Never commit .devdaily.secrets.json to version control. DevDaily automatically adds it to .gitignore during devdaily init.

Environment Variables

Configuration values can also be set via environment variables:

# Project Management
export JIRA_BASE_URL="https://yourcompany.atlassian.net"
export JIRA_EMAIL="your@email.com"
export JIRA_API_TOKEN="your-token"
export LINEAR_API_KEY="lin_api_..."
export NOTION_API_KEY="secret_..."
export NOTION_DATABASE_ID="..."

# Notifications
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."

Next Steps

Git Hooks

Set up automatic snapshots with git hooks

Project Management

Integrate with GitHub, Jira, or Linear

Notifications

Configure Slack and Discord webhooks

PR Templates

Customize PR descriptions with templates

Get Started

Core Features

Configuration

Advanced

Troubleshooting

Configuration Overview

Configuration File Locations

JSON Schema Support

Example Configuration

Configuration Categories

Display Settings

Command Aliases

Output Preferences

Git Settings

Multi-Project Support

Keyboard Shortcuts

Journal / Auto-Snapshots

AI/Copilot Settings

Managing Configuration

View Current Configuration

Edit Configuration

Reset to Defaults

Secrets Management

Environment Variables

Next Steps

Git Hooks

Project Management

Notifications

PR Templates

​Configuration File Locations

​JSON Schema Support

​Example Configuration

​Configuration Categories

​Display Settings

​Command Aliases

​Output Preferences

​Git Settings

​Multi-Project Support

​Keyboard Shortcuts

​Journal / Auto-Snapshots

​AI/Copilot Settings

​Managing Configuration

​View Current Configuration

​Edit Configuration

​Reset to Defaults

​Secrets Management

​Environment Variables

​Next Steps

Git Hooks

Project Management

Notifications

PR Templates

Configuration File Locations

JSON Schema Support

Example Configuration

Configuration Categories

Display Settings

Command Aliases

Output Preferences

Git Settings

Multi-Project Support

Keyboard Shortcuts

Journal / Auto-Snapshots

AI/Copilot Settings

Managing Configuration

View Current Configuration

Edit Configuration

Reset to Defaults

Secrets Management

Environment Variables

Next Steps