Skip to main content

​
deadfall init

Initialize Deadfall in the current project.

​
Usage

deadfall init [flags]

​
Description

The init command sets up Deadfall in your project by:
  1. Creating deadfall.json configuration file
  2. Adding Deadfall files to .gitignore
  3. Optionally configuring MCP clients (with --mcp flag)

​
Flags

FlagDescription
--mcpAlso configure MCP clients (Claude Desktop, Cursor)
--jsonOutput in JSON format
-v, --verboseEnable verbose output

​
Examples

​
Basic Initialization

deadfall init
Output: 
✓ Created deadfall.json
✓ Updated .gitignore

Deadfall initialized! Next steps:
  1. Create a trap:    deadfall trap cursor-rules
  2. Start the server: deadfall serve
  3. Check status:     deadfall status

​
Initialize with MCP Configuration

deadfall init --mcp
This automatically adds Deadfall’s Honey-MCP server to:
  • Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)
  • Cursor (~/.cursor/mcp.json)

​
Configuration File

After initialization, deadfall.json contains: 
{
  "traps": []
}
This file tracks all deployed traps and their tokens for alert correlation.

​
What’s Added to .gitignore

# Deadfall Security
deadfall.json
deadfall_alerts.log