Skip to main content

​
Description

Interactive setup wizard that configures DevDaily for your environment. Sets up shell aliases, completions, configuration files, PM tool integrations, and git hooks.

​
Usage

devdaily init [options]

​
Options

​
-g, --global
boolean
Set up globally for all projects (uses ~/.devdaily.json)
​
--alias
boolean
Only set up shell alias (dd)
​
--completions
boolean
Only set up shell completions
​
--config
boolean
Only create config file
​
--pm
boolean
Only set up project management integration
​
--notifications
boolean
Only set up Slack/Discord notifications
​
--git-hooks
boolean
Install git hooks for automatic snapshots (post-commit, post-checkout)
​
--remove-hooks
boolean
Remove previously installed devdaily git hooks

​
Examples

​
Interactive setup

devdaily init

​
Global setup

devdaily init --global

​
Just shell alias

devdaily init --alias

​
PM integration only

devdaily init --pm

​
Notifications only

devdaily init --notifications

​
Install git hooks

devdaily init --git-hooks

​
Remove git hooks

devdaily init --remove-hooks

​
Setup Features

​
Shell Alias

Adds dd as a shortcut for devdaily: 
dd standup
dd pr
dd week
Supported shells: zsh, bash, fish

​
Shell Completions

Enables tab completion for:
  • Commands (standup, pr, week, etc.)
  • Options (—days, —format, etc.)
  • Subcommands

​
Configuration File

Creates:
  • Local: .devdaily.json in project root
  • Global: ~/.devdaily.json in home directory
Stores preferences for:
  • Default branch
  • Output format
  • Theme colors
  • PM tool settings

​
PM Integration

Supported tools:
  • GitHub Issues (default, uses gh CLI)
  • Jira (API token required)
  • Linear (API key required)
  • Notion (integration token required)
Collects credentials and stores them securely in .devdaily.secrets.json (auto-added to .gitignore).

​
Notifications

Configures webhooks for:
  • Slack - Incoming Webhooks
  • Discord - Webhook URLs
Allows sending standups directly to team channels.

​
PR Prompt File

Creates .devdaily-pr-prompt.md with sample guidelines: 
# PR Description Guidelines

Our team prefers:
- Focus on the "why" not the "what"
- Include testing notes
- Reference ticket IDs
Customize this file to match your team’s PR standards.

​
Git Hooks

Installs hooks to automatically take snapshots:
  • post-commit - After each commit
  • post-checkout - When switching branches
Works safely alongside existing hooks.

​
Interactive Setup Flow

When running devdaily init without options:
  1. Shell Setup - Alias and completions
  2. Config File - Local or global
  3. PM Tool - Select and configure
  4. Default Branch - Auto-detect or specify
  5. PR Settings - Diff inclusion, max lines
  6. PR Prompt - Create custom guidelines
  7. Notifications - Slack/Discord webhooks
  8. Git Hooks - Auto-snapshot setup

​
Configuration Location

​
Local (per-project)

  • Config: .devdaily.json
  • Secrets: .devdaily.secrets.json
  • Location: Repository root

​
Global (user-wide)

  • Config: ~/.devdaily.json
  • Secrets: ~/.devdaily.secrets.json
  • Location: Home directory

​
Secrets Storage

Sensitive credentials are stored in .devdaily.secrets.json: 
{
  "jira": {
    "baseUrl": "https://company.atlassian.net",
    "email": "you@company.com",
    "apiToken": "..."
  },
  "slack": {
    "webhookUrl": "https://hooks.slack.com/..."
  }
}
This file is automatically added to .gitignore.

​
After Setup

Restart your shell or run: 
# zsh/bash
source ~/.zshrc  # or ~/.bashrc

# fish
source ~/.config/fish/config.fish
Then test: 
dd standup
dd pr
dd week

​
Requirements

  • Shell: zsh, bash, or fish
  • Git repository (for local setup)
  • Optional: gh CLI for GitHub features
  • Optional: PM tool API access