Default Settings

Default configuration is stored in config/default.json.

Full Configuration

{
  "server": {
    "port": 7860,
    "host": "127.0.0.1"
  },
  "tailscale": {
    "enabled": true,
    "servePorts": [],
    "useFunnel": false
  },
  "telegram": {
    "enabled": true,
    "commands": {
      "status": { "cmd": "git status", "description": "Git status" },
      "pull": { "cmd": "git pull", "description": "Git pull" },
      "log": { "cmd": "git log --oneline -10", "description": "Recent commits" },
      "diff": { "cmd": "git diff --stat", "description": "Git diff summary" },
      "install": { "cmd": "npm install", "description": "Install dependencies" },
      "build": { "cmd": "npm run build", "description": "Build project" },
      "test": { "cmd": "npm test", "description": "Run tests" },
      "dev": { "cmd": "npm run dev", "description": "Start dev server", "long": true },
      "ls": { "cmd": "ls -la", "description": "List files" },
      "branch": { "cmd": "git branch -a", "description": "List branches" }
    }
  },
  "terminal": {
    "shell": "",
    "scrollback": 5000
  }
}

Server Options

OptionDefaultDescription
port7860HTTP server port
host127.0.0.1Bind address

Tailscale Options

OptionDefaultDescription
enabledtrueEnable Tailscale integration
servePorts[]Additional ports to expose
useFunnelfalseUse Funnel (public) instead of Serve

Telegram Options

OptionDefaultDescription
enabledtrueEnable Telegram bot
commands(see above)Predefined command shortcuts

Custom Commands

Add your own commands to telegram.commands:

{
  "telegram": {
    "commands": {
      "deploy": {
        "cmd": "npm run deploy",
        "description": "Deploy to production"
      },
      "logs": {
        "cmd": "tail -f logs/app.log",
        "description": "View logs",
        "long": true
      }
    }
  }
}

Set "long": true for commands that run continuously.

Terminal Options

OptionDefaultDescription
shell$SHELL or /bin/zshShell to use
scrollback5000Terminal history lines