ForgeLocal MCP Server - Command Line Reference
============================================

Version: 1.8.67
Source of truth: HTP_JSON_Lib\Server\MCP_Commandline.inc and startup flow in HTP_JSON_Lib\MCP_Server.bas
Last sync: 2026-03-03

WARNING: Advanced usage. Run command-line options at your own risk.

Usage:
 SindByte 01.exe [options]

Switch format:
  - Prefix: "/" or "-"
  - Value separator: ":" or "="
  - Quotes supported for values with spaces: /PROMPT:"text"
  - Unknown options are ignored.

Boolean values (for boolean switches):
  1, true, yes, on, enabled, enable
  0, false, no, off, disabled, disable

Global options
--------------
  /HELP, /H, /?
    Show command-line help and exit.

  /DIALOG, /D
    Open Dialog form.

  /CONFIG, /C
    Open Config Editor.

  /SETTIMER, /ST
    Open SetTimer form.

  /KRAKEN, /KTRADE, /KT
    Open Kraken trading form.

  /LMCHAT, /LMC, /CHAT
    Open LMChat window directly.

  /CONSOLE, /CON, /CLI
    Reserved / internal Console launch flag (currently only sets console-mode flag).

  /AUTOSTART, /AUTO, /A
    Enable startup automation on GUI forms (dialog/settimer/kraken).

  /APIPROVIDER[:true|false], /APIPROV[:true|false], /ENDPOINTPROVIDER[:...], /ENDPOINT[:...], /APIPROVIDERON
    Force endpoint provider usage on/off before initialization.
    When enabled, /AUTOSTART is implicitly enabled.

  /CONFIG:file
    Use alternate config file.

  /REGCATS[:auto|true|false|short|full], /REGCATEGORIES[:...], /REGISTERONLYCATEGORIES[:...], /REGMODE[:short|full|auto]
    Startup tool registration mode override.
    short => category-only mode, full => full tool registration, auto/default => auto threshold.

  /UTC[:true|false], /CLOCKUTC[:...], /SHOWUTC[:...]
    Force server clock display to UTC (true) or local (false).

  /LOCALTIME[:true|false], /CLOCKLOCAL[:...], /SHOWLOCALTIME[:...]
    Force server clock display to local time (false for UTC mode).

Dialog options
--------------
  /PROMPT:"text", /PROMPT:text
    Initial prompt/message. Also used as timer prompt fallback.

  /MODELA:<model>, /A:<model>
    Model A for dialog.

  /MODELB:<model>, /B:<model>
    Model B for dialog.

  /MODELC:<model>, /C:<model>
    Model C (OpenAI path in UI).

  /RULES:"text", /RULES:text or /R:"text"
    Initial debate/rules text.

  /ROUNDS:n, /N:n
    Number of rounds (clamped to 1..2000).
    Default: 2000

  /IQ:<mode>, /MODE:<mode>
    Initial IQ mode: direct, chainofthought, cot, selfcritique, multivote, validate.

  /TOOLS, /USETOOLS, /T
    Enable LM tools in Dialog UI.

  /OUTPUT:file, /O:file
    Save discussion output to file.

  /DIALOGTAB:setup|debate|logs|thinking, /DIALOG_TAB:..., /DTAB:..., /TAB:...
  /DIALOGTAB:0..3, /DTAB:0..3, /TAB:0..3
    Set startup tab (0=setup, 1=debate, 2=logs, 3=thinking).

  /SHOWTHINKING:true|false, /SHOWTHINK:..., /THINKING:...
    Open Thinking tab when dialog tab is not explicitly set.

SetTimer options
----------------
  /TIMERPROMPT:"text", /TIMERPROMPT:text
    Prompt for timer task.

  /TIMERNAME:text, /NAME:text
    Timer display name.

  /TIMERMODEL:model, /TIMERMODEL2:model, /TIMERMODELB:model, /MODEL2:model
    Primary and secondary model IDs.

  /PROVIDER:local|openai|openrouter, /TIMERPROVIDER:...
    Explicitly set provider for timer model resolution.

  /SCHEDULE:once|interval|daily|weekly|hourly_window, /SCHED:...
    Scheduler mode.

  /RUNAT:"yyyy-mm-dd hh:mm", /RUNAT:...
    For run-once schedules.

  /INTERVAL:n, /TIME:n
    Interval minutes (clamped to 1..1440).

  /COUNT:n, /REPS:n
    Repeat count (clamped to 1..999). Note: UI does not expose repeat count, so behavior is schedule-focused.

  /DAILYTIME:HH:MM, /DAILY_TIME:...
    Hour/minute for daily/weekly schedule.

  /WEEKDAYS:mon,tue,...,sun, /DOW:...
    Comma-separated list for weekly schedule.

  /HOURSTART:n, /HOUR_START:n
  /HOUREND:n, /HOUR_END:n
    Execution hour limits, each clamped to 0..23.

  /ENABLED:true|false
    Timer enabled state.

  /PERSISTENCE:permanent|session, /PERSIST:...
    Persistence mode.

  /USE_DIRECT_LM:true|false, /DIRECTLM:...
    Use direct LM mode.

  /USE_TOOLS:true|false, /TOOLSEN:...
    Enable tools for timer execution.

  /DELAY_UNTIL_FREE:true|false, /DELAYFREE:...
    Enable ?delay until free? behavior.

  /SOFTTIMEOUT:n, /SOFT_TIMEOUT_SECONDS:n
    Soft timeout in seconds (clamped to 0..86400).

  /IQTOOLS:chainofthought,selfcritique,multivote,validate,crossresolve,ensemble,debate,betterprompt, /IQ_TOOLS:...
    Comma-separated IQ tool selectors.

  /IQFLOW:auto|fanout|pipeline, /IQ_EXEC_MODE:...
    IQ execution flow.

  /COTSTEPS:n, /COT_MAX_STEPS:n
    CoT steps (clamped to 3..12).

  /SELFITERS:n, /SELF_ITERATIONS:n
    Self-critique iteration count (clamped to 1..5).

  /SELFQUALITY:n, /SELF_QUALITY_THRESHOLD:n
    Self-critique quality threshold (clamped to 1..10).

  /MVVOTES:n, /MV_VOTE_COUNT:n
    Multi-vote count (clamped to 3..7).

  /MVMODE:vote|synthesize, /MV_MODE:...
    Multi-vote combination mode.

  /VALATTEMPTS:n, /VAL_MAX_ATTEMPTS:n
    Validation attempt count (clamped to 1..5).

  /VALTYPE:all|factual|logic|code|complete, /VAL_VALIDATION_TYPE:...
    Validation type.

  /CROSSROUNDS:n, /CROSS_MAX_ROUNDS:n
    Cross-resolution rounds (clamped to 1..3).

  /ENSASPECTS:n, /ENS_ASPECT_COUNT:n
    Ensemble aspect count (clamped to 2..6).

  /ENSMERGE:sequential|parallel, /ENS_MERGE_STRATEGY:...
    Ensemble merge strategy.

  /DEBROUNDS:n, /DEB_ROUNDS:n
    Debate rounds (clamped to 1..5).

  /DEBCONCLUSION:both|winner|synthesis, /DEB_CONCLUSION_TYPE:...
    Debate conclusion mode.

  /VISIONOPENAI:true|false, /VISION_USE_OPENAI:...
    Toggle OpenAI vision support.

  /VISIONMODEL:model, /VISION_MODEL:...
    Vision model identifier.

  /STTMODEL:model, /STT_MODEL:...
    STT model identifier.

  /TESTNOW, /RUNNOW, /NOW
    In SetTimer, run immediate test prompt (no scheduled save).

  /AUTOSTART (also with SetTimer)
    Save timer configuration automatically when prompt/model data is present
    (ignored when /TESTNOW is used).

Kraken options
--------------
  /KTTIMERNAME:text
    Timer name for Kraken auto scheduling.

  /KTPROVIDER:local|openai|openrouter
    Kraken provider.

  /KTMODEL:model, /KTMODELA:model, /KTMODEL2:model, /KTMODELB:model
    Primary and secondary Kraken models.

  /KTPAIR:BTC/USD
    Trading pair symbol.

  /KTTIMEFRAME:1m|5m|15m|1h|4h|1d, /KTTF:...
    Timeframe.

  /KTINTERVAL:n, /KTEVERY:n
    Interval minutes (clamped to 1..1440).

  /KTSTRATEGY:text
    Strategy preset.

  /KTMM:text
    Money-management preset.

  /KTRISK:n
    Risk percent per trade (numeric text).

  /KTMAXDD:n
    Max drawdown percent.

  /KTLEV:n, /KTLEVERAGE:n
    Leverage cap.

  /KTPROMPT:text, /KTCUSTOM:text
    Kraken custom strategy prompt.

  /KTUSETOOLS:true|false, /KTBETTER:true|false, /KTMULTIVOTE:true|false, /KTLIVE:true|false
    Expert toggles.

  /KTRUNONCE, /KTRUN, /KTRUNNOW
    Open Kraken form and execute one run immediately.

  /KTMANUAL, /KTMANUALOPEN, /KTMAN
    Open manual trading panel.

  /KTMANUALCLOSEMS:n, /KTMANUALAUTOCLOSE:n
    Auto-close manual panel after n ms (clamped to 0..120000).

  /KTMANUALCLOSEMSG:text, /KTMANUALMSG:text
    Message shown before auto-closing manual panel.

Execution behavior notes
-----------------------
- Parse phase runs before initialization; help option exits immediately.
- /APIPROVIDER override is applied after MCP initialization.
- /AUTOSTART behavior:
  - Dialog: if /PROMPT is present, discussion is auto-triggered.
  - SetTimer: auto-saves timer unless /TESTNOW is used.
  - Kraken: auto-starts trading automation when /KTRUNONCE is not set.
- Unknown command-line switches are ignored.

Examples
--------
  SindByte 01.exe /HELP
  SindByte 01.exe /DIALOG /PROMPT:"Explain quantum" /A:lm:llama3.1
  SindByte 01.exe /D /PROMPT:"Solve this" /A:lm:phi4 /B:lm:llama3.1 /IQ:multivote /T
  SindByte 01.exe /D /DTAB:thinking /SHOWTHINKING:true
  SindByte 01.exe /SETTIMER /TIMERMODEL:lm:openai/gpt-oss-20b /TIMERMODEL2:lm:glm-4.7 /INTERVAL:30 /USE_DIRECT_LM:true /USE_TOOLS:true /IQFLOW:fanout /IQTOOLS:multivote,crossresolve /TESTNOW
  SindByte 01.exe /APIPROVIDER:true /REGMODE:short /UTC:true
  SindByte 01.exe /KRAKEN /KTPROVIDER:openai /KTMODEL:gpt-4o-mini /KTPAIR:BTC/USD /KTTIMEFRAME:15m /KTINTERVAL:15 /KTRUNONCE
  SindByte 01.exe /CONFIG:"myconfig.json" /AUTOSTART
