+pikuri+ is the convenience bundle for the pikuri AI-assistant toolkit. It ships no Ruby code of its own beyond a tiny entry file that +require+'s each sibling gem; +gem install pikuri+ pulls in pikuri-core, pikuri-extractors, pikuri-pdf, pikuri-skills, pikuri-tasks, pikuri-memory, pikuri-workspa...

pikuri-assistant ships the demo +bin/pikuri-assistant+ binary on top of pikuri-core + pikuri-skills + pikuri-mcp: an interactive chat agent the user hand-edits to declare a +Pikuri::Mcp::Registry+ of MCP servers. The +Pikuri.prompt+ search path picks up this gem's +prompts/pikuri-assistant.txt+ a...

pikuri-code adds the shell-and-dev-loop layer on top of pikuri-workspace's filesystem tools: a +Pikuri::Code::Bash+ that runs commands via the +Pikuri::Subprocess+ chokepoint with +Confirmer+ gating (optionally wrapped in a +Pikuri::Code::Bash::Sandbox::Bubblewrap+ filesystem sandbox), plus the d...

pikuri-extractors plugs additional document formats into pikuri-core's +Pikuri::Extractor+ registry. The bundled +Pikuri::Extractors::DOCUMENTS+ extractor converts office documents (DOCX, ODT, XLSX, legacy XLS, PPTX, EPUB, RTF) to Markdown by piping the bytes through pandoc / markitdown — prefera...

pikuri-mcp adds Model Context Protocol support to pikuri-core agents: a +Pikuri::Mcp::Registry+ for declaring stdio + HTTP MCP servers, the +Pikuri::Mcp::Servers+ runtime that spawns them, a +Pikuri::Mcp::Synthesizer+ that LLM-fills missing server descriptions, a +Pikuri::Mcp::Verifier+ that scre...

pikuri-memory gives a pikuri-core agent durable, long-lived memory: facts about the user and their work that persist across conversations. It wires a +recall+ tool plus an automatic per-turn prefetch onto an agent via +c.add_extension Pikuri::Memory::Extension.new(...)+ inside the +Agent.new+ blo...

pikuri-pdf plugs PDF → text extraction into pikuri-core's +Pikuri::Extractor+ registry. The bundled +Pikuri::Extractors::PDF+ extractor wraps the pure-Ruby pdf-reader gem and extracts lazily: paged reads (the +read+ tool's windows) parse only the pages the window needs, so the first page of a 500...

pikuri-skills implements the Agent Skills standard (agentskills.io) for pikuri-core agents: a +Pikuri::Skill::Catalog+ that discovers skill folders under .pikuri/skills, .claude/skills, and .agents/skills; a +Pikuri::Skill::SkillTool+ that loads a skill's body on demand; and a +Pikuri::Skill::Ext...

pikuri-subagents owns the sub-agent (delegation) feature top to bottom: the +Pikuri::SubAgent::SubAgentTool+ class (exposed to the LLM as the +agent+ tool), the +Persona+ record, the +Extension+ that wires it onto an agent, and the bundled +Pikuri::SubAgent::RESEARCHER+ persona (network-read only...

pikuri-tasks gives a pikuri-core agent an in-memory task list it can use to plan and track multi-step work. A +Pikuri::Tasks::List+ holds the per-Agent state; four tools (+task_create+, +task_in_progress+, +task_completed+, +task_delete+) mutate it via content-as-identifier (no item IDs to halluc...

pikuri-vectordb gives a pikuri-core agent a +vectordb_search+ tool over a local document corpus — agentic search, the agent decides when to retrieve. Ships a swappable backend (a pure-Ruby +Backend::InMemory+ for teaching, plus thin +Backend::Qdrant+ / +Backend::Chroma+ HTTP clients for persisten...

pikuri-workspace adds "operate on a directory tree" to pikuri-core agents: the +Pikuri::Workspace::Filesystem+ class that scopes filesystem access to an anchor + explicit readable / writable prefix lists (with optional ephemeral temp playground), the +Pikuri::Workspace::Confirmer+ seam (+AUTO_APP...