recursive-agent 0.8.2

A Rust coding-agent platform: kernel, tools, multi-agent orchestration, HTTP API, MCP, and TUI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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
42
43
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

"""
Recursive Agent SDK — Python client.

Claude Agent SDK–compatible ``query()`` (recommended)::

    import asyncio
    from recursive_sdk import query, ClaudeAgentOptions

    async def main():
        async for message in query(
            prompt="list files in the project",
            options=ClaudeAgentOptions(max_turns=5),
        ):
            if message.get("type") == "result":
                print(message.get("result"))

    asyncio.run(main())

Session-style API (also available)::

    from recursive_sdk import Agent
    result = Agent.prompt("list files in the project")

Environment variables:

- ``RECURSIVE_BIN`` — path to the ``recursive`` binary (CLI transport)
- ``RECURSIVE_BASE_URL`` — when set, ``Agent.*`` uses HTTP instead of CLI
- ``RECURSIVE_API_KEY`` — API key (if the HTTP server has auth enabled)
"""

from .agent import Agent
from .exceptions import RecursiveAgentError
from .models import (
    AssistantMessage,
    GoalState,
    PartialAssistantMessage,
    RunResult,
    SessionInfo,
    SystemMessage,
    TextContent,
    ToolProgressMessage,
    ToolResultBlock,
    ToolUseBlock,
    UsageMeta,
    UserMessage,
)
from .query import ClaudeAgentOptions, Query, query
from .run import Run

__version__ = "0.6.0"

__all__ = [
    "query",
    "Query",
    "ClaudeAgentOptions",
    "Agent",
    "Run",
    "RunResult",
    "AssistantMessage",
    "UserMessage",
    "SystemMessage",
    "TextContent",
    "ToolUseBlock",
    "ToolResultBlock",
    "ToolProgressMessage",
    "PartialAssistantMessage",
    "GoalState",
    "UsageMeta",
    "SessionInfo",
    "RecursiveAgentError",
]