Setup
Prepare the current VerticalBar Agent runtime for use. On desktop, open the app and sign in when needed; on headless Linux, verify CrossCheck auth without attempting a window or interactive login. Use when the user says setup / sign in / log in / open the app / show the agent window / "띄워줘", when a CrossCheck or Vertical Bar tool has failed for want of an identity, or before any flow that needs an identified user (starting a CI workflow run, NetSuite onboarding).From its SKILL.md
npx -y skills add verticalbarHQ/verticalbar-agent --skill setupAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.0 KB, as published. Nobody here has run it
Setup — prepare this runtime
One outcome: the current runtime is prepared, or its exact configuration gap is identified. A
desktop runtime can open the VerticalBar Agent window and establish Cognito identity. A headless
runtime cannot; it can use a host-provided CC_API_KEY for CrossCheck only.
Decide the runtime first
-
Call
runtime_infobeforeloginor any attempt to open the app. Use itsruntime.surface,runtime.mode,runtime.canOpenWindow, andauthfields as facts. Do not infer capability from the host OS, the operator's wording, or environment variables visible in chat. In particular, the Node compatibility surface is GUI-less even when its OS is macOS or Windows. -
If it reports
headless, follow Headless below. Otherwise follow Desktop. -
Before any workspace-scoped CrossCheck call, follow
workspaceRouting:api-key-bound→ call the requested CrossCheck tool withoutworkspaceId; do not callcc_workspacesbecause API-key auth cannot enumerate Cognito workspaces.discover→ if the current request has no workspace selected from an earlier authenticated result, callcc_workspaces. Use its sole result automatically. If it returns more than one, show the safe workspace names and ask the user to choose; never select the first or invent an ID. Pass the returnedworkspaceIdto the original tool and retry it at most once.unavailable→ resolve authentication first as described below.
Vertical Bar follows the same rule through
vb_workspaces; never substitute a CrossCheck workspace list or an account/tenant number for its returnedworkspaceId.
Headless
- Never call
login, open a browser, or run the binary in GUI mode. This runtime has no supported interactive sign-in or window surface. - If
auth.crosscheckisapi-keyorcognito, report that CrossCheck authentication is configured and continue with the requested CrossCheck work. Presence is not a server-side validity check; if a tool returns an authentication or authorization error, treat that refusal as authoritative. - If
auth.crosscheckisnone, tell the operator to setCC_API_KEYin the MCP host environment and restart the MCP server. Never ask them to paste the key into chat or a tool argument. CC_API_KEYis CrossCheck-only. Ifauth.verticalbarisnone, say that Vertical Bar tools need a Cognito session established from a desktop-capable runtime; do not present the API key as a substitute.- Do not claim that a headless runtime is signed in merely because CrossCheck API-key auth is ready.
Desktop compiled client
runtime_info is authoritative about whether a live session already exists. Do not call login
when the requested service already reports cognito; continue the original task. Opening the app
window is a separate user request and does not require re-authentication.
Do this
-
If the needed auth is
none, calllogin(no arguments). The branded window opens and the user signs in with Google or email/password. The call returns when a token lands. Treat that as successful authentication and resume the user's original task.If the needed auth is already
cognito, skiplogin. Do not create an approval-bearing authentication subflow merely to prove a session thatruntime_infoalready reported.The managed Cognito Hosted UI is never shown; that path was removed. If
CC_API_KEYis set, note that it covers CrossCheck only — Vertical Bar still needs this login, so do not report an API key as a substitute. -
Only when the user asked to see/open the app, open the window yourself — the same binary in GUI mode, run with no arguments:
macOS ~/Library/Application Support/verticalbar-agent/<target>/app/VerticalBar Agent.app/Contents/MacOS/verticalbar-agent Windows %LOCALAPPDATA%\verticalbar-agent\<target>\app\verticalbar-agent.exeResolve
<target>by listing that directory rather than guessing the triple — it is the platform target the launcher installed for this machine, and it changes between architectures. Launch it detached so it outlives the tool call.Never re-download or re-install it here. The launcher owns installation and signature verification, and it re-verifies before every spawn. If the binary is not there, say so and stop: an unverified binary you fetched yourself is exactly what that design prevents.
-
Resume the original task. A successful
loginis a completed authentication subflow, not a terminal answer when the user asked for a read or another tool action.
Switching accounts on desktop
logout clears the cached CrossCheck and Vertical Bar tokens; run it before login to sign in
as somebody else. It does not touch a CC_API_KEY fallback, so a stale key can still answer for
CrossCheck after a logout — mention it rather than letting the next call look like the new account.
Do not
- Do not skip
runtime_info; setup behavior is selected by the runtime surface it reports. - Do not call
loginor attempt to open a window whenruntime.modeisheadless. - Do not call
loginwhenruntime_infoalready reports the needed Cognito session. - Do not open the managed Cognito web UI, or send the user to a browser to sign in. The window is the only supported path.
- Do not run the binary with
--mcphere. That is the stdio server Claude Code already speaks to; starting a second one gives you a process nobody is talking to.