{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "vlinx-io-velaterm--let-agent-sessions-search-and-message-each-other",
 "repo": "vlinx-io/VelaTerm",
 "repo_url": "https://github.com/vlinx-io/VelaTerm",
 "repo_slug": "vlinx-io-velaterm",
 "title": "Let agent sessions search and message each other",
 "page_title": "How to let agent sessions search and message each other with Vela Term",
 "summary": "Use vsearch, vrefer and vtell so one agent can pull in work from another session.",
 "who": "A developer whose agent needs context from earlier conversations in other sessions on the same project.",
 "problem": "Relevant decisions and findings are scattered across several agent sessions, and copying them by hand is slow and error-prone.",
 "outcome": "An agent can find earlier conversations, read or ask about them, and send a message to another running session.",
 "steps": [
  "Start two sessions running Claude Code, Codex, OpenCode or Pi in the same project.",
  "In one session, use the vsearch command to search every session for earlier work on the topic you need.",
  "Use vrefer to read the matching conversation or ask a question about it.",
  "Use vtell to message the other session, adding --steer if the message should join a turn that is already running."
 ],
 "agent_prompt": "In the VelaTerm project at <project-path>, have one agent session use vsearch to find earlier work on <topic>, then vrefer to read the best match. Expected output: a short summary of the matched conversation with its session name. Verify that the summary cites a real session from the tree before you act on it.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Advanced",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "The README names vsearch, vrefer and vtell but does not show their arguments, so check the user manual before scripting them.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "typescript",
 "requirements": [
  "A computer running macOS, Windows or Linux",
  "The VelaTerm installer from velaterm.com/download",
  "A logged-in local Codex or Claude Code install for agent sessions and audits",
  "A phone with the VelaTerm iOS or Android app for mobile access"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/vlinx-io-velaterm/let-agent-sessions-search-and-message-each-other/",
 "md": "https://dedupedai.com/use-cases/vlinx-io-velaterm/let-agent-sessions-search-and-message-each-other/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/vlinx-io-velaterm--let-agent-sessions-search-and-message-each-other.json",
 "api_version": "v1"
}