devdaily init

Set up DevDaily with aliases, completions, config, and integrations

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": "[e-mail]",
    "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