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

theme

object

Color theme for terminal output

Show properties

primary

string

default:"blue"

Primary color for headings and highlights

success

string

default:"green"

Color for success messages

warning

string

default:"yellow"

Color for warnings

error

string

default:"red"

Color for errors

accent

string

default:"cyan"

Accent color for secondary elements

muted

string

default:"gray"

Color for muted/dimmed text

ascii

boolean

default:"true"

Show ASCII art banners

animations

boolean

default:"true"

Enable loading spinners and animations

compactMode

boolean

default:"false"

Use compact output with less whitespace

Command Aliases

aliases

object

Custom command aliases for faster access

Show properties

standup

string[]

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

Aliases for standup command

string[]

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

Aliases for pr command

week

string[]

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

Aliases for week command

dash

string[]

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

Aliases for dash command

Output Preferences

output

object

Output formatting and behavior

Show properties

format

enum

default:"markdown"

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

copyToClipboard

boolean

default:"true"

Automatically copy output to clipboard

showStats

boolean

default:"true"

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

verbose

boolean

default:"false"

Enable verbose logging

Git Settings

git

object

Git repository configuration

Show properties

defaultBranch

string

default:"main"

Default branch name for comparisons

excludeAuthors

string[]

default:"[]"

Authors to exclude from analysis

excludePatterns

string[]

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

Commit message patterns to exclude

Multi-Project Support

projects

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"
  }
]

activeProject

string

Currently active project name

Keyboard Shortcuts

shortcuts

object

Keyboard shortcuts for interactive commands

Show properties

quit

string

default:"q"

Quit/exit

help

string

default:"?"

Show help

refresh

string

default:"r"

Refresh data

copy

string

default:"c"

Copy to clipboard

create

string

default:"enter"

Create/submit

back

string

default:"esc"

Go back

nextProject

string

default:"tab"

Next project

prevProject

string

default:"shift+tab"

Previous project

Journal / Auto-Snapshots

journal

object

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

Show properties

autoSnapshot

boolean

default:"true"

Automatically take snapshots when running commands

gitHooks

boolean

default:"false"

Install git hooks for automatic snapshots

hooks.postCommit

boolean

default:"true"

Enable post-commit hook

hooks.postCheckout

boolean

default:"true"

Enable post-checkout hook

quiet

boolean

default:"true"

Suppress snapshot side-effect messages

autoPromptDays

number

default:"0"

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

AI/Copilot Settings

copilot

object

GitHub Copilot CLI configuration

Show properties

timeout

number

default:"30000"

Request timeout in milliseconds

retries

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/..."
  }
}

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

Get Started

Core Features

Configuration

Advanced

Troubleshooting

Documentation Index

​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