+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-skills, pikuri-workspace, pikuri-code, pikuri-mcp, and pikuri-assistant in one shot, and +require 'pikuri'+ boots all of them. Privacy-conscious users who want a minimal dependency tree to audit should install +pikuri-core+ directly and opt into the extension gems they actually need — same +bundle add+ pattern Rails users have always had. See each pikuri-* gem's README for its individual surface.

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+ automatically on require — same multi-gem prompt-dir pattern as pikuri-code.

pikuri-code adds the shell-and-dev-loop layer on top of pikuri-workspace's filesystem tools: a +Pikuri::Tool::Bash+ that runs commands via the +Pikuri::Subprocess+ chokepoint with +Confirmer+ gating, plus the demo +bin/pikuri-code+ binary that wires file + shell + web tools into an interactive coding agent rooted at the current working directory. The +Pikuri.prompt+ search path picks up this gem's +prompts/coding-system-prompt.txt+ automatically on require.

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 screens server surfaces for prompt-injection patterns before any tool is advertised to the LLM, and a +Pikuri::Mcp::Extension+ that wires everything into a +Pikuri::Agent+ via +c.add_extension(...)+ in the +Agent.new+ block.

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::Extension+ that wires both into a +Pikuri::Agent+ via +c.add_extension(...)+ in the +Agent.new+ block.

pikuri-workspace adds "operate on a directory tree" to pikuri-core agents: the +Pikuri::Tool::Workspace+ seam (abstract base + +Workspace::Cwd+) that scopes filesystem access to a chosen root, the +Pikuri::Tool::Confirmer+ seam (+AUTO_APPROVE+ + +TERMINAL+) for user-state mutations, and five tools wired to those seams: +Pikuri::Tool::Read+, +Pikuri::Tool::Write+, +Pikuri::Tool::Edit+, +Pikuri::Tool::Grep+, and +Pikuri::Tool::Glob+. Self-contained — no shell execution; +Pikuri::Tool::Bash+ ships in pikuri-code on top of these.