๐Ÿงฉ Embeds

This page is the operator reference for [TAG] placeholders used in Amy/Ompcord Discord embed templates.

Rendering rule: keep the reference table plain and scroll-safe. Put JavaScript examples in fenced code blocks below the table, not inside raw HTML table tooltips.

Placeholder reference

CategoryPlaceholderTypeSourceMeaning
๐Ÿ”Œ Discord gateway[BOT_TAG]stringOmpcord BridgeDiscord bot user tag, e.g. Amy#0305
๐Ÿ”Œ Discord gateway[GATEWAY_STATUS]emoji stringAmy SSOT DashboardGateway readiness, e.g. ๐ŸŸข Ready / ๐Ÿ”ด Offline
๐Ÿ”Œ Discord gateway[GUILD_ID]snowflake stringAmy SSOT DashboardActive Discord guild ID
๐Ÿ”Œ Discord gateway[HOME_CHANNEL_MENTION]Discord mentionAmy SSOT DashboardHome channel mention, e.g. <#...>
๐Ÿ”Œ Discord gateway[ACTIVE_THREAD_MENTION]Discord mentionAmy Session ContinuityActive thread mention, e.g. <#...>
๐Ÿ”Œ Discord gateway[GATEWAY_PING]millisecondsOmpcord BridgeDiscord websocket latency
๐Ÿƒ Active run[RUN_STATE]emoji stringAmy SSOT DashboardBusy/idle state
๐Ÿƒ Active run[RUN_PHASE]stringAmy SSOT DashboardCurrent task/todo phase
๐Ÿƒ Active run[RUN_STEP]numberAmy SSOT DashboardStep/tool iteration count
๐Ÿƒ Active run[RUN_LAST_TOOLS]stringAmy SSOT DashboardRecent tool trace, e.g. read โ€บ search โ€บ edit
๐Ÿƒ Active run[RUN_TOOL_GLYPHS]emoji stringAmy SSOT DashboardRecent tools as compact symbols
๐Ÿƒ Active run[RUN_ELAPSED]durationAmy SSOT DashboardCurrent run duration
๐Ÿƒ Active run[RUN_PROMPT_EXCERPT]stringAmy SSOT DashboardTruncated active prompt/goal
๐Ÿƒ Active run[RUN_STATUS_MESSAGE]stringAmy SSOT DashboardCurrent agent status text
๐Ÿค– Model/API[MODEL_NAME]stringAmy SSOT DashboardCurrent model ID
๐Ÿค– Model/API[MODEL_PROVIDER]stringAmy SSOT DashboardProvider inferred from runtime/model
๐Ÿค– Model/API[MODEL_API]stringAmy SSOT DashboardAPI protocol used by omp
๐Ÿ’ณ Usage/billing[USAGE_INPUT]formatted numberomp npm plugins quick-startInput token count
๐Ÿ’ณ Usage/billing[USAGE_OUTPUT]formatted numberomp npm plugins quick-startOutput token count
๐Ÿ’ณ Usage/billing[USAGE_CACHE_READ]formatted numberomp npm plugins quick-startCache-read token count
๐Ÿ’ณ Usage/billing[USAGE_TOTAL]formatted numberomp npm plugins quick-startTotal token count
๐Ÿ’ณ Usage/billing[USAGE_COST]USD stringomp npm plugins quick-startEstimated cost when usage is available
๐Ÿ’ณ Usage/billing[USAGE_BILLING_SUMMARY]stringAmy SSOT DashboardOne-line input/cache/output/cost summary
๐Ÿ“‹ Todo progress[TODO_TOTAL_PHASES]numberAmy SSOT DashboardTotal todo phases
๐Ÿ“‹ Todo progress[TODO_ACTIVE_PHASE]stringAmy SSOT DashboardCurrent phase name
๐Ÿ“‹ Todo progress[TODO_ACTIVE_CHECKLIST]markdown stringAmy SSOT DashboardCurrent phase checklist
๐Ÿ“‹ Todo progress[TODO_PHASE_SUMMARY]stringAmy SSOT DashboardCompact phase progress summary
๐Ÿ“‹ Todo progress[TODO_COMPLETED_COUNT]numberAmy SSOT DashboardCompleted task count
โš™๏ธ Daemon/system[DAEMON_PID]numberOmpcord BridgeParent daemon PID
โš™๏ธ Daemon/system[DAEMON_UPTIME]durationOmpcord BridgeParent daemon uptime
โš™๏ธ Daemon/system[DAEMON_VERSION]semver/stringAmy SSOT DashboardStatus schema/runtime version
โš™๏ธ Daemon/system[DAEMON_WORKDIR]pathOmpcord BridgeCurrent daemon working directory
โš™๏ธ Daemon/system[DAEMON_SESSION_DIR]pathAmy Session ContinuityRoot session directory
โš™๏ธ Daemon/system[DAEMON_ALLOW_LIST]mention listOmpcord BridgeAllowed Discord user mentions
โš™๏ธ Daemon/system[DAEMON_MEMORY]sizeOmpcord BridgeRuntime RSS/heap memory indicator
๐Ÿ”ง Settings[CONFIG_REACTIONS]emojiAmy SSOT DashboardReaction feedback enabled/disabled
๐Ÿ”ง Settings[CONFIG_TOOL_LOGS]emojiAmy SSOT DashboardTool output logging enabled/disabled
๐Ÿ”ง Settings[CONFIG_AUTO_START]emojiAmy SSOT DashboardAuto-start behavior enabled/disabled
๐Ÿ”ง Settings[CONFIG_USE_THREADS]emojiAmy Session ContinuityThread routing enabled/disabled
๐Ÿ”ง Settings[CONFIG_LOG_DETAIL]emojiAmy SSOT DashboardVerbose dashboard logging enabled/disabled
โฑ๏ธ Last run[LAST_RUN_SUCCESS]emojiAmy SSOT DashboardLast run success/error indicator
โฑ๏ธ Last run[LAST_RUN_EXIT_CODE]numberAmy SSOT DashboardChild process exit code when available
โฑ๏ธ Last run[LAST_RUN_TIME]Discord timestampAmy SSOT DashboardRelative completion timestamp
โฑ๏ธ Last run[LAST_RUN_ERROR]stringAmy SSOT DashboardLast captured error text

Safe formatting examples

bot_tag

// ๐Ÿค– Active bot tag, e.g. 'Amy#0305'
const botTag = client.user.tag

gateway_status

// ๐Ÿ“ก Gateway readiness status (๐ŸŸข Ready / ๐Ÿ”ด Offline)
const gatewayStatus = state.gateway.ready ? "๐ŸŸข Ready" : "๐Ÿ”ด Offline"

guild_id

// ๐Ÿ†” Active Discord guild ID
const guildId = guild.id

home_channel_mention

// ๐Ÿ“ข Mentions the home channel, e.g. '<#123456789>'
const homeChannelMention = `<#${state.discord.homeChannelId}>`

active_thread_mention

// ๐Ÿงต Mentions the active session thread, e.g. '<#123456789>'
const threadMention = `<#${state.discord.activeThreadId}>`

gateway_ping

// โšก WebSocket heartbeat ping latency in milliseconds
const ping = client.ws.ping

run_state

// ๐Ÿšฆ Current agent run state (๐Ÿƒ Busy / ๐Ÿ˜ด Idle)
const runState = running ? "๐Ÿƒ Busy" : "๐Ÿ˜ด Idle"

run_phase

// ๐Ÿ—บ๏ธ Current task/todo phase name
const phase = activeRun.phase

run_step

// ๐Ÿ”ข Step/tool iteration count
const step = activeRun.stepCount

run_last_tools

// ๐Ÿ› ๏ธ Recent tool trace, e.g. 'read โ€บ search โ€บ edit'
const lastTools = run.lastTools.join(" โ€บ ")

run_tool_glyphs

// ๐Ÿ”ฎ Recent tools as compact symbols
const toolGlyphs = run.lastTools.map(getGlyph).join("")

run_elapsed

// โฑ๏ธ Current run duration
const elapsed = formatDuration(Date.now() - startTime)

run_prompt_excerpt

// ๐Ÿ“ Truncated active prompt/goal
const promptExcerpt = prompt.substring(0, 100) + "..."

run_status_message

// ๐Ÿ’ฌ Current agent status text
const statusMessage = activeRun.statusMessage

model_name

// ๐Ÿง  Current model ID, e.g. 'gemini-3.5-flash'
const modelName = config.model

model_provider

// ๐Ÿข Provider inferred from model, e.g. 'Google'
const modelProvider = getProvider(config.model)

model_api

// ๐Ÿ“ก API protocol used by omp
const modelApi = config.apiType

usage_input

// ๐Ÿ“ฅ Input token count from model response
const inputTokens = usage.inputTokens

usage_output

// ๐Ÿ“ค Output token count from model response
const outputTokens = usage.outputTokens

usage_cache_read

// ๐Ÿ’พ Tokens fetched from context cache
const cacheTokens = usage.cacheReadTokens

usage_total

// โž• Total token count for this run
const totalTokens = usage.totalTokens

usage_cost

// ๐Ÿ’ธ Estimated cost in USD
const cost = usage.cost

usage_billing_summary

// ๐Ÿ“Š One-line token and cost summary
const summary = `๐Ÿ“ฅ ${fmt(u.input)}  ๐Ÿ’พ ${fmt(u.cacheRead)} cache  ๐Ÿ“ค ${fmt(u.output)}  ๐Ÿ’ธ $${u.cost.toFixed(4)}`

todo_total_phases

// ๐Ÿ“‹ Total todo phases
const totalPhases = checklist.phases.length

todo_active_phase

// ๐ŸŽฏ Current phase name
const activePhase = checklist.activePhase.name

todo_active_checklist

// ๐Ÿ“ Formatted markdown todos checklist for current phase
const lines = phase.items.map((item) => {
  if (item.status === "done") return `โœ… ${item.task}`
  if (item.status === "in_progress") return `โžก๏ธ ${item.task}`
  return `โ—ฝ ${item.task}`
})

todo_phase_summary

// ๐Ÿ“ˆ Compact phase progress summary
const summary = `${done}/${total} tasks`

todo_completed_count

// โœ… Completed task count
const completedCount = checklist.totalDone

daemon_pid

// โš™๏ธ Parent daemon PID
const daemonPid = process.pid

daemon_uptime

// โฑ๏ธ Parent daemon uptime
const uptime = formatDuration(process.uptime())

daemon_version

// ๐Ÿ“ฆ Status schema/runtime version
const version = pkg.version

daemon_workdir

// ๐Ÿ“ Current daemon working directory
const workdir = process.cwd()

daemon_session_dir

// ๐Ÿ—„๏ธ Root session directory
const sessionDir = getSessionDir()

daemon_allow_list

// ๐Ÿ‘ฅ Allowed Discord user mentions
const allowList = config.allowedUsers.join(", ")

daemon_memory

// ๐Ÿง  Runtime RSS/heap memory indicator
const memory = process.memoryUsage().rss

config_reactions

// ๐ŸŽญ Reaction feedback status (enabled/disabled)
const reactions = config.useReactions ? "โœ…" : "โŒ"

config_tool_logs

// ๐Ÿ—ƒ๏ธ Tool output logging status (enabled/disabled)
const toolLogs = config.logTools ? "โœ…" : "โŒ"

config_auto_start

// โšก Auto-start behavior status (enabled/disabled)
const autoStart = config.autoRun ? "โœ…" : "โŒ"

config_use_threads

// ๐Ÿงต Thread routing status (enabled/disabled)
const useThreads = config.useThreads ? "โœ…" : "โŒ"

config_log_detail

// ๐Ÿ” Detailed debug logs status (enabled/disabled)
const logDetail = config.verbose ? "โœ…" : "โŒ"

last_run_success

// ๐Ÿ Last run success/error indicator
const success = lastRun.ok ? "๐ŸŸข" : "๐Ÿ”ด"

last_run_exit_code

// ๐Ÿšซ Child process exit code
const exitCode = lastRun.exitCode

last_run_time

// ๐Ÿ“… Relative completion timestamp
const runTime = lastRun.timestamp

last_run_error

// ๐Ÿšจ Last captured error text
const error = lastRun.errorText

Source-truth references

Ask Docs

AI assistant to help answer questions about the documentation. Answers are read-only and cite docs/source.

Hi! How can I help you with the documentation today? Answers are read-only and cite docs/source.

Ctrl+Enter to send