Menu
Source Code skill for the ikigai project
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Automated quality check loops with escalation and fix sub-agents
JSON-based end-to-end test format, runner, and mock provider
Jujutsu (jj) skill for the ikigai project
How to write effective Ralph goals for Ikigai-driven workflows
Create and manage Ralph goals from Ikigai using the real ralph-pipeline scripts
Create repositories using the real ralph-pipeline repo-create script
Based on SOC occupation classification
| name | source-code |
| description | Source Code skill for the ikigai project |
Comprehensive reference for all C source files in the Ikigai REPL project organized by functional area.
src/main.c - Main entry point for the REPL application, loads configuration and initializes the event loop.src/shared.c - Shared context initialization for terminal, rendering, database, and history.src/panic.c - Panic handler for unrecoverable errors with safe async-signal-safe cleanup.src/error.c - Error handling wrapper using talloc-based allocator for consistent memory management.src/config.c - Configuration file loading and parsing with tilde expansion and default config creation.src/credentials.c - API key management with environment variable and JSON file (~/.ikigai/credentials.json) support.src/logger.c - Thread-safe logging system with ISO 8601 timestamps and local timezone support.src/uuid.c - UUID generation using base64url encoding for compact agent identifiers.src/array.c - Generic expandable array implementation with configurable element size and growth strategy.src/byte_array.c - Typed wrapper for byte (uint8_t) arrays built on top of the generic array.src/line_array.c - Typed wrapper for line (char*) arrays built on top of the generic array.src/json_allocator.c - Talloc-based allocator for yyjson providing consistent memory management.src/terminal.c - Raw mode and alternate screen buffer management with CSI u support detection.src/signal_handler.c - Signal handling infrastructure for SIGWINCH (terminal resize) events.src/ansi.c - ANSI escape sequence parsing and color code generation utilities.src/render.c - Direct ANSI terminal rendering with text and cursor positioning.src/render_cursor.c - Cursor screen position calculation accounting for UTF-8 widths and line wrapping.src/layer.c - Output buffer management for composable rendering layers.src/layer_scrollback.c - Scrollback layer wrapper that renders conversation history.src/layer_input.c - Input buffer layer wrapper that renders the current user input.src/layer_separator.c - Separator layer wrapper that renders horizontal separators with debug info and navigation context.src/layer_spinner.c - Spinner layer wrapper for animated loading indicators with frame cycling.src/layer_completion.c - Completion layer wrapper that renders tab completion suggestions.src/event_render.c - Universal event renderer that converts database events to styled scrollback content.src/scrollback.c - Scrollback buffer implementation with line wrapping and layout caching.src/scrollback_layout.c - Layout calculation for scrollback lines with segment width tracking and newline handling.src/scrollback_render.c - Scrollback rendering helper functions for calculating display positions and byte offsets.src/scrollback_utils.c - Utility functions for scrollback text analysis including display width calculation with ANSI escape handling.src/scroll_detector.c - Distinguishes mouse wheel scrolling from keyboard arrow key presses using timing-based burst detection.src/input.c - Input parser that converts raw bytes to semantic actions with UTF-8 and escape sequence handling.src/input_escape.c - Escape sequence parsing for terminal control codes with CSI sequence handling.src/input_xkb.c - XKB keyboard layout support for translating shifted keys to their base characters using reverse mapping.src/input_buffer/core.c - Input buffer text storage implementation with UTF-8 support and layout caching.src/input_buffer/cursor.c - Cursor position tracking with byte and grapheme offset management using utf8proc.src/input_buffer/cursor_pp.c - Cursor pretty-print implementation for debugging with structured output.src/input_buffer/layout.c - Input buffer layout caching for efficient display width calculation with ANSI handling.src/input_buffer/multiline.c - Multi-line navigation implementation for up/down arrow keys with line start/end detection.src/input_buffer/pp.c - Input buffer pretty-print implementation for debugging with nested structure visualization.src/repl.c - REPL main event loop with select()-based multiplexing for input, HTTP, and tool execution.src/repl_init.c - REPL initialization and cleanup with session restoration support and agent tree reconstruction.src/repl_viewport.c - Viewport calculation logic for determining what's visible on screen with scroll offset tracking.src/repl_callbacks.c - HTTP callback handlers for streaming OpenAI responses with line buffering.src/repl_event_handlers.c - Event handlers for stdin, HTTP completion, tool completion, and timeouts with timeout calculation.src/repl_tool.c - Tool execution helper that runs tools in background threads with mutex-protected result passing.src/repl_tool_completion.c - Tool completion handling with tool loop continuation and provider request submission.src/repl_actions.c - Core action processing including arrow key handling through scroll detector with multiline scrollback append.src/repl_actions_llm.c - LLM and slash command handling with conversation management and command dispatching.src/repl_actions_viewport.c - Viewport and scrolling actions (page up/down, scroll up/down) with max offset calculation.src/repl_actions_history.c - History navigation actions (Ctrl+P/N for previous/next) with pending entry preservation.src/repl_actions_completion.c - Tab completion functionality for slash commands with auto-update after character insertion.src/agent.c - Agent context creation and lifecycle management with layer system, conversation state, and mutex initialization.src/agent_messages.c - Agent message handling for adding messages to conversation arrays with capacity growth.src/agent_provider.c - Agent provider interface for lazy-initializing LLM providers with caching.src/agent_state.c - Agent state machine transitions between idle, waiting, and tool-executing states.src/repl_agent_mgmt.c - REPL agent array management for adding/removing agents with capacity growth.src/repl_navigation.c - Agent navigation helpers for switching between agents and finding by UUID.src/repl/agent_restore.c - Agent restoration on startup with conversation replay, mark stack reconstruction, and sorted agent tree building.src/repl/agent_restore_replay.c - Agent restoration replay helpers for populating conversation and scrollback from database.src/commands.c - REPL command registry and dispatcher for slash commands (/clear, /help, /model, /system, /debug, etc).src/commands_basic.c - Basic command implementations (/clear, /help, /system, /debug).src/commands_mark.c - Mark and rewind command implementations for conversation checkpoints with database truncation.src/commands_model.c - Model command implementation for switching AI models with provider validation.src/commands_fork.c - Fork command handler for creating child agents with quoted prompt parsing and conversation cloning.src/commands_fork_args.c - Fork command argument parsing with quoted prompt extraction and message ID detection.src/commands_fork_helpers.c - Fork command helper functions for agent creation and conversation cloning.src/commands_kill.c - Kill command handler for terminating agents and descendants with depth-first collection and database updates.src/commands_mail.c - Mail command handlers (/send, /inbox) for inter-agent messaging with unread count tracking.src/commands_mail_helpers.c - Mail command helper functions for message formatting and delivery.src/commands_agent_list.c - /agents command implementation for displaying agent hierarchy tree with indentation and status.src/marks.c - Mark creation and management with ISO 8601 timestamps and scrollback rendering.src/completion.c - Tab completion data structures and fuzzy matching logic with model/agent argument providers.src/history.c - Command history management with capacity limits and duplicate detection.src/history_io.c - History persistence to JSON file with load/save operations.src/db/connection.c - PostgreSQL connection management with connection string validation and automatic migrations.src/db/migration.c - Database schema migration system with version tracking and directory scanning.src/db/session.c - Session management for creating and querying conversation sessions.src/db/message.c - Message persistence with event kind validation, parameterized queries, and conversation/metadata filtering.src/db/agent.c - Agent persistence with insert/update/list operations and status tracking.src/db/agent_row.c - Agent row parsing from PostgreSQL results with field extraction.src/db/agent_zero.c - Root agent (Agent 0) creation and lookup for ensuring root agent exists.src/db/agent_replay.c - Agent replay helpers for finding clear events and loading conversation history with mark boundaries.src/db/mail.c - Mail message persistence with insert/query/update operations for inter-agent messaging.src/db/replay.c - Replay context for loading and replaying conversation history with mark stack, message array, and rewind support.src/db/pg_result.c - PGresult wrapper with automatic cleanup using talloc destructors for RAII-style resource management.src/providers/factory.c - Provider factory for creating provider instances by name with API key lookup.src/providers/provider.c - Model capability lookup with thinking support detection and provider inference from model name.src/providers/request.c - Request builder implementation for constructing LLM requests with messages, tools, and thinking config.src/providers/request_tools.c - Standard tool definitions (glob, file_read, grep, bash, file_write) and schema generation.src/providers/response.c - Response builder for constructing LLM responses with content blocks and usage statistics.src/providers/stubs.c - Stub implementations placeholder (actual implementations in provider-specific directories).src/providers/common/error_utils.c - Error category utilities for mapping HTTP status codes and determining retryability.src/providers/common/http_multi.c - Shared HTTP multi-handle client for async requests with curl integration.src/providers/common/http_multi_info.c - HTTP multi-handle info reading and completion callback dispatching.src/providers/common/sse_parser.c - Server-Sent Events parser for streaming HTTP responses with event extraction.src/providers/anthropic/anthropic.c - Anthropic provider implementation with vtable for async HTTP operations.src/providers/anthropic/error.c - Anthropic error handling with HTTP status mapping and error response parsing.src/providers/anthropic/request.c - Anthropic request serialization to Messages API format with thinking config.src/providers/anthropic/request_serialize.c - Anthropic request serialization helpers for content blocks and tool_use format.src/providers/anthropic/response.c - Anthropic response parsing with finish reason mapping.src/providers/anthropic/response_helpers.c - Anthropic response parsing helper functions.src/providers/anthropic/streaming.c - Anthropic streaming implementation with SSE parsing and context management.src/providers/anthropic/streaming_events.c - Anthropic SSE event processors for message_start, content_block, and message_delta.src/providers/anthropic/thinking.c - Anthropic thinking budget implementation with model-specific limits.src/providers/openai/openai.c - OpenAI provider implementation with vtable for async HTTP operations.src/providers/openai/error.c - OpenAI error handling with HTTP status mapping and content filter detection.src/providers/openai/openai_handlers.c - OpenAI HTTP completion handlers for non-streaming and streaming requests.src/providers/openai/reasoning.c - OpenAI reasoning effort implementation for o-series models.src/providers/openai/request_chat.c - OpenAI Chat Completions request serialization with strict mode and reasoning_effort.src/providers/openai/request_responses.c - OpenAI Responses API request serialization.src/providers/openai/response_chat.c - OpenAI Chat Completions response parsing with tool call extraction.src/providers/openai/response_responses.c - OpenAI Responses API response parsing with reasoning tokens.src/providers/openai/serialize.c - OpenAI JSON serialization for messages with role and content handling.src/providers/openai/streaming_chat.c - OpenAI Chat Completions streaming implementation with context creation.src/providers/openai/streaming_chat_delta.c - OpenAI Chat Completions delta processing for streaming events.src/providers/openai/streaming_responses.c - OpenAI Responses API streaming implementation.src/providers/openai/streaming_responses_events.c - OpenAI Responses API event processing.src/providers/google/google.c - Google Gemini provider implementation with vtable for async HTTP operations.src/providers/google/error.c - Google error handling with HTTP status mapping and error response parsing.src/providers/google/request.c - Google request serialization to Gemini contents/parts format.src/providers/google/request_helpers.c - Google request serialization helpers for content blocks and role mapping.src/providers/google/response.c - Google response parsing with content parts extraction.src/providers/google/response_error.c - Google error response parsing with category mapping.src/providers/google/response_utils.c - Google response utilities including tool ID generation and finish reason mapping.src/providers/google/streaming.c - Google streaming implementation with response builder.src/providers/google/streaming_helpers.c - Google streaming helper functions for tool call handling and error mapping.src/providers/google/thinking.c - Google thinking implementation with model series detection and budget/level handling.src/tool.c - Tool call data structures and JSON schema generation for OpenAI function definitions with parameter helpers.src/tool_dispatcher.c - Tool dispatcher that routes tool calls to appropriate handlers with JSON validation and error envelope building.src/tool_arg_parser.c - Tool argument parsing utilities for extracting string/boolean/integer parameters from JSON.src/tool_response.c - Tool response building helpers for success/error envelopes with custom data callbacks.src/tool_bash.c - Bash command execution tool using popen with output capture and exit code extraction.src/tool_file_read.c - File reading tool with error handling for missing/inaccessible files and size limits.src/tool_file_write.c - File writing tool with error handling for permission/space issues and byte counting.src/tool_glob.c - File pattern matching tool using glob() with JSON result formatting and count tracking.src/tool_grep.c - Pattern search tool using regex with file filtering, line matching, and result formatting.src/format.c - Format buffer implementation for building strings with printf-style formatting and JSON appending.src/pp_helpers.c - Pretty-print helpers for debugging data structures with indentation and type formatting.src/fzy_wrapper.c - Wrapper for fzy fuzzy matching library used in tab completion with scoring and prefix matching.src/debug_pipe.c - Debug output pipe system for capturing tool output in separate channels with non-blocking reads.src/msg.c - Canonical message format utilities for distinguishing conversation kinds from metadata events.src/message.c - Message creation utilities for building ik_message_t structures with text, tool calls, and tool results.src/file_utils.c - File I/O utilities for reading entire files with error handling and size limits.src/mail/msg.c - Mail message structure creation with timestamp generation and field initialization.src/wrapper_curl.c - libcurl function wrappers with mockable link seams for testing.src/wrapper_internal.c - Internal ikigai function wrappers for database, scrollback, and provider operations.src/wrapper_json.c - yyjson wrapper implementations for JSON parsing and generation.src/wrapper_posix.c - POSIX system call wrappers for file operations and terminal control.src/wrapper_postgres.c - PostgreSQL function wrappers for database queries and result handling.src/wrapper_pthread.c - pthread wrapper implementations for mutex and thread operations.src/wrapper_stdlib.c - C standard library wrappers for formatting and time functions.src/wrapper_talloc.c - talloc wrapper implementations for memory allocation and string operations.src/vendor/yyjson/yyjson.c - High-performance JSON library for parsing and generation (vendored).src/vendor/fzy/match.c - Fuzzy string matching algorithm from the fzy project with bonus scoring (vendored).