Skip to content

channels_cmd

channels_cmd

jarvis channels — manage messaging channels for the agent.

Functions

channels 

channels() -> None

Manage messaging channels (iMessage/SMS via SendBlue, Slack).

Source code in src/openjarvis/cli/channels_cmd.py 
12
13
14
@click.group("channels")
def channels() -> None:
    """Manage messaging channels (iMessage/SMS via SendBlue, Slack)."""

channels_status 

channels_status() -> None

Show status of all configured channels.

Source code in src/openjarvis/cli/channels_cmd.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
@channels.command("status")
def channels_status() -> None:
    """Show status of all configured channels."""
    from openjarvis.channels.imessage_daemon import is_running

    console = Console()
    table = Table(title="Channel Status")
    table.add_column("Channel", style="bold")
    table.add_column("Status")
    table.add_column("Details", style="dim")

    if is_running():
        table.add_row(
            "iMessage",
            "[green]running[/green]",
            "Polling chat.db",
        )
    else:
        table.add_row(
            "iMessage",
            "[dim]stopped[/dim]",
            "jarvis channels imessage-start <contact>",
        )

    console.print(table)

imessage_start 

imessage_start(chat_identifier: str, background: bool) -> None

Start the iMessage daemon for CHAT_IDENTIFIER.

CHAT_IDENTIFIER is the phone number or email to monitor.

Source code in src/openjarvis/cli/channels_cmd.py 
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
@channels.command("imessage-start")
@click.argument("chat_identifier")
@click.option(
    "--background/--foreground",
    default=True,
    help="Run in background.",
)
def imessage_start(
    chat_identifier: str,
    background: bool,
) -> None:
    """Start the iMessage daemon for CHAT_IDENTIFIER.

    CHAT_IDENTIFIER is the phone number or email to monitor.
    """
    from openjarvis.channels.imessage_daemon import (
        is_running,
        run_daemon,
    )

    console = Console()

    if is_running():
        console.print("[yellow]iMessage daemon already running.[/yellow]")
        return

    if background:
        import subprocess

        proc = subprocess.Popen(
            [
                sys.executable,
                "-m",
                "openjarvis.channels.imessage_daemon",
                "--chat",
                chat_identifier,
            ],
            stdout=subprocess.DEVNULL,
            stderr=subprocess.DEVNULL,
            start_new_session=True,
        )
        console.print(
            f"[green]iMessage daemon started[/green] "
            f"(PID {proc.pid})\n"
            f"Monitoring: {chat_identifier}\n"
            "Text this contact from your iPhone "
            "to chat with the agent."
        )
    else:
        console.print(
            f"[green]Starting iMessage daemon[/green] — monitoring {chat_identifier}"
        )
        console.print("Press Ctrl+C to stop.\n")

        from openjarvis.agents.deep_research import (
            DeepResearchAgent,
        )
        from openjarvis.connectors.retriever import (
            TwoStageRetriever,
        )
        from openjarvis.connectors.store import KnowledgeStore
        from openjarvis.core.config import load_config
        from openjarvis.core.events import EventBus
        from openjarvis.engine.ollama import OllamaEngine
        from openjarvis.security import setup_security
        from openjarvis.tools.knowledge_search import (
            KnowledgeSearchTool,
        )
        from openjarvis.tools.knowledge_sql import (
            KnowledgeSQLTool,
        )
        from openjarvis.tools.scan_chunks import ScanChunksTool
        from openjarvis.tools.think import ThinkTool

        config = load_config()
        bus = EventBus(record_history=False)
        security = setup_security(config, OllamaEngine(), bus)
        engine = security.engine
        store = KnowledgeStore()
        retriever = TwoStageRetriever(store)
        tools = [
            KnowledgeSearchTool(retriever=retriever),
            KnowledgeSQLTool(store=store),
            ScanChunksTool(
                store=store,
                engine=engine,
                model="qwen3.5:4b",
            ),
            ThinkTool(),
        ]
        agent = DeepResearchAgent(
            engine=engine,
            model="qwen3.5:4b",
            tools=tools,
            bus=bus,
            capability_policy=security.capability_policy,
            rate_limiter=security.rate_limiter,
            agent_id="channel:imessage",
        )

        def handler(text: str) -> str:
            result = agent.run(text)
            return result.content or "No results found."

        run_daemon(
            chat_identifier=chat_identifier,
            handler=handler,
        )

imessage_stop 

imessage_stop() -> None

Stop the iMessage daemon.

Source code in src/openjarvis/cli/channels_cmd.py 
154
155
156
157
158
159
160
161
162
163
@channels.command("imessage-stop")
def imessage_stop() -> None:
    """Stop the iMessage daemon."""
    from openjarvis.channels.imessage_daemon import stop_daemon

    console = Console()
    if stop_daemon():
        console.print("[green]iMessage daemon stopped.[/green]")
    else:
        console.print("[dim]iMessage daemon is not running.[/dim]")