Documentation
¶
Overview ¶
Command pig provides the PiG coding agent CLI.
pig divergence (D2): refuse the `pi` name to protect Pi's command identity.
pig: Go-native port of pi-coding-agent.
Distinct binary name and config root from upstream pi to avoid PATH collisions and shared-config corruption. See codingagent.ConfigRoot() for the on-disk layout (defaults to ~/.pig, override with $PIG_HOME).
Usage:
pig [options] [prompt]
Options:
--model <provider/model> Model to use (default: from settings) --agent <name> Agent definition to load from <config>/agents/ --print <prompt> Print mode: send prompt and print response, then exit --no-extensions Disable all extensions -e <path> Load extension (can be repeated) --skill <name> Load a skill --cwd <dir> Working directory (default: current dir) --agent-dir <dir> Agent config directory (default: <config>/agent) --version Print version and exit
Ports packages/coding-agent/src/core/resource-loader.ts
Ports packages/coding-agent/src/modes/rpc/rpc-mode.ts
Ports packages/coding-agent/src/modes/rpc/rpc-mode.ts
Ports packages/coding-agent/src/modes/json-event.ts.
Ports packages/coding-agent/src/modes/rpc/rpc-mode.ts
Ports packages/coding-agent/src/modes/rpc/rpc-mode.ts
Startup timing instrumentation for pig.
Activated by setting PIG_STARTUP_TRACE=1. Prints structured timing to stderr showing wall-clock elapsed from process start for each startup. Uses Go's monotonic clock via time.Since.
Usage:
PIG_STARTUP_TRACE=1 pig --model github-copilot/gpt-5-mini
Output:
[startup] flags-parsed 0ms [startup] services-init 2ms [startup] model-resolved 3ms [startup] extensions-loaded 25ms [startup] session-created 28ms [startup] interactive-ready 130ms
This is the official profiling mechanism. Do NOT add ad-hoc fmt.Fprintf timing to main.go or interactive.go: use this.
Source Files
¶
- a_doc.go
- agent_environment.go
- args.go
- auth_check.go
- auth_command.go
- auth_commands.go
- auth_contributions.go
- auth_run.go
- build_command.go
- builtin_extensions.go
- chalk_color.go
- cli_error.go
- cli_runtime_build.go
- cli_session_factory.go
- config_command.go
- configured_resources.go
- credential_print.go
- diagnose.go
- extension_command.go
- extension_init_command.go
- extension_login_preview_command.go
- extension_scoped_models.go
- extension_set.go
- extension_tool_registry.go
- extension_validate_command.go
- extensions.go
- extensions_cache_command.go
- guard.go
- headless_reload.go
- headless_resources.go
- interactive_build.go
- llama.go
- main.go
- main_default.go
- mcp_command.go
- model.go
- package_command_trust.go
- package_commands.go
- package_git.go
- package_inventory.go
- package_model_catalogs.go
- package_npm_metadata.go
- package_progress.go
- package_resource_selection.go
- package_temporary.go
- package_update_operations.go
- package_updates.go
- piglet_skills.go
- piglet_tool_owner.go
- print_mode.go
- print_mode_build.go
- profiling.go
- project_trust.go
- reload_resources.go
- render_overflow.go
- resolve_cli_model.go
- resource_prompts.go
- resource_source_info.go
- rpc_admission.go
- rpc_dispatch.go
- rpc_events.go
- rpc_initial_tools.go
- rpc_json_diagnostic.go
- rpc_mode.go
- rpc_mode_runtime.go
- rpc_object.go
- rpc_settle_gate.go
- rpc_shutdown.go
- rpc_shutdown_unix.go
- rpc_types.go
- rpc_ui.go
- self_update.go
- session_extension_actions.go
- setup_cli.go
- setup_command.go
- startup_model.go
- startup_session.go
- startup_settings.go
- startup_source_resolver.go
- startup_trace.go
- status_command.go
- stdout_queue.go
- termination_shutdown.go
- theme_init.go
- verify_command.go