{"schema_version":1,"workflow_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","workflow_title":"AI Shell — Natural Language to Shell Commands","page_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","raw_url":"https://tokrepo.com/raw/ai-shell-natural-language-shell-commands-da61dedb","metadata_url":"https://tokrepo.com/metadata/ai-shell-natural-language-shell-commands-da61dedb.json","install_plan_url":"https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=da61dedb-cb50-41f6-bb0c-72013a520bd6&target=codex","recommended_install":{"schema_version":1,"status":"stage","policy":"stage_only","install_mode":"stage_only","target":"codex","command":"npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target codex","dry_run_command":"npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target codex --dry-run --json","runtime_commands":{"codex":"npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target codex","gemini":"npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target gemini","project":"npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6"},"prompt":"Install and make this TokRepo asset usable: \"AI Shell — Natural Language to Shell Commands\".\n\nPage: https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb\nUUID: da61dedb-cb50-41f6-bb0c-72013a520bd6\nTarget adapter: codex\nPolicy/mode: stage_only / stage_only\n\nRead these machine-facing entry points first:\n- metadata: https://tokrepo.com/metadata/ai-shell-natural-language-shell-commands-da61dedb.json\n- install contract: https://tokrepo.com/install-contract/ai-shell-natural-language-shell-commands-da61dedb.json\n- install plan: https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=da61dedb-cb50-41f6-bb0c-72013a520bd6&target=codex\n- raw content: https://tokrepo.com/raw/ai-shell-natural-language-shell-commands-da61dedb\n\nCommands:\n- choose the current runtime; do not use unsupported CLI targets.\n- Codex: npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target codex\n- Gemini CLI: npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 --target gemini\n- Claude Code / project agent: run npx -y tokrepo@latest install da61dedb-cb50-41f6-bb0c-72013a520bd6 from the project root; add `--dry-run --json` first to inspect the plan.\n- add `--dry-run --json` to the chosen command first; after the plan allows it, run the chosen command.\n\nExecution rules:\n1. Run the install command to stage the asset safely.\n2. Read the staged README, install-plan, and entrypoint files.\n3. Activate scripts, MCP config, or global config only after user confirmation.\n4. Verify usability with the install-plan post_verify checks and the asset README.\n\nReport back with changed files, verification result, and how to use the asset next.","next_steps":["Run the install command to stage the asset safely.","Read the staged README, install-plan, and entrypoint files.","Activate scripts, MCP config, or global config only after user confirmation.","Verify usability with the install-plan post_verify checks and the asset README."],"success_check":["The asset is safely staged.","The agent can give clear activation steps from the staged content."]},"agent_metadata":{"asset_kind":"script","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"ai-shell.md","risk_profile":{"executes_code":true,"modifies_global_config":false,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","verification":{"commands":[],"expected_files":["ai-shell.md"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind script","install_mode stage_only","policy stage_only","asset_kind script is not activated directly for Codex","install_mode is stage_only","risk_profile.executes_code is true","trust established"],"asset_kind":"script","install_mode":"stage_only"},"trust":{"author_trust_level":"established","verified_publisher":false,"asset_signed_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["executes_code","script","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","author has published assets","content hash available"]},"provenance":{"owner_uuid":"8a910e34-3180-11f1-9bc6-00163e2b0d79","owner_name":"Script Depot","source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","visibility":1,"created_at":"2026-04-01 12:14:16","updated_at":"2026-07-03 01:33:04"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"install_plan":{"schema_version":2,"target":"codex","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","asset_title":"AI Shell — Natural Language to Shell Commands","source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","install_mode":"stage_only","entrypoint":"ai-shell.md","preconditions":[{"type":"target_supported","status":"pass","message":"codex install target is supported"},{"type":"install_root","status":"pass","message":"~/.codex/skills for activated assets; ~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6 for staged assets"},{"type":"target_tool_metadata","status":"pass","message":"metadata allows codex"},{"type":"content_hash","status":"pass","message":"asset metadata includes content_hash"},{"type":"trust_policy","status":"pass","message":"publisher trust level is established"},{"type":"policy_decision","status":"warn","message":"stage_only for da61dedb-cb50-41f6-bb0c-72013a520bd6 (stage_only)"}],"actions":[{"type":"stage_file","path":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6/ai-shell.md","source_name":"ai-shell.md","sha256":"bdbc988ae7e958abf030be9632d79ac53a8dc1cd3fc1a37aaf53ed2da051c4e4","bytes":1477,"risk":{"executes_code":true,"modifies_global_config":false,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"if_exists":"overwrite"}],"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind script is not activated directly for Codex","install_mode is stage_only","risk_profile.executes_code is true"]},"requires_confirmation":false,"rollback":[{"type":"remove_file","path":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6/ai-shell.md"}],"post_verify":[{"type":"file_sha256","path":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6/ai-shell.md","sha256":"bdbc988ae7e958abf030be9632d79ac53a8dc1cd3fc1a37aaf53ed2da051c4e4"},{"type":"expected_file","path":"ai-shell.md"}],"metadata":{"asset_kind":"script","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"ai-shell.md","risk_profile":{"executes_code":true,"modifies_global_config":false,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","verification":{"commands":[],"expected_files":["ai-shell.md"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind script","install_mode stage_only","policy stage_only","asset_kind script is not activated directly for Codex","install_mode is stage_only","risk_profile.executes_code is true","trust established"],"asset_kind":"script","install_mode":"stage_only"},"trust":{"author_trust_level":"established","verified_publisher":false,"asset_signed_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["executes_code","script","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","author has published assets","content hash available"]},"provenance":{"owner_uuid":"8a910e34-3180-11f1-9bc6-00163e2b0d79","owner_name":"Script Depot","source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","visibility":1,"created_at":"2026-04-01 12:14:16","updated_at":"2026-07-03 01:33:04"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"evidence_bundle":{"acceptance_gate":{"recommended_action":"stage_or_request_confirmation","rule":"Agents should only activate an asset after evidence_bundle.integrity, policy_compatibility, rollback, and post_verify have been inspected.","status":"caution"},"asset_title":"AI Shell — Natural Language to Shell Commands","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","eval_evidence":["https://tokrepo.com/evals/install-safety.json","https://tokrepo.com/evals/trust-evidence-coverage.json","https://tokrepo.com/evals/handoff-quality.json"],"generated_at":"2026-07-02T17:33:06Z","integrity":{"content_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","declared_content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","file_count":1,"hash_algorithm":"sha256","install_plan_hash":"786afce7201b734dc293d8b6c36e84999bf70939ba41c855d46bc43fed38fad6"},"policy_compatibility":{"permission_envelope":{"destructive":false,"executes_code":true,"file_count":1,"filesystem_write":["~/.codex/tokrepo/staged"],"global_config_write":false,"network":false,"requires_secrets":[],"uses_absolute_paths":false},"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind script is not activated directly for Codex","install_mode is stage_only","risk_profile.executes_code is true"]},"requires_confirmation":false,"target":"codex","trust_score_v2":{"recommended_action":"stage_or_request_confirmation","status":"caution","trust_score":60}},"provenance":{"asset_kind":"script","asset_title":"AI Shell — Natural Language to Shell Commands","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","computed_bundle_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","created_at":"2026-04-01 12:14:16","generated_at":"2026-07-02T17:33:06Z","install_plan_hash":"786afce7201b734dc293d8b6c36e84999bf70939ba41c855d46bc43fed38fad6","owner_name":"Script Depot","owner_uuid":"8a910e34-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","updated_at":"2026-07-03 01:33:04","visibility":1},"sbom":{"asset_kind":"script","asset_title":"AI Shell — Natural Language to Shell Commands","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","capability_flags":{"destructive":false,"executes_code":true,"modifies_global_config":false,"network_access":false,"requires_secrets":[]},"content_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":1477,"path":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6/ai-shell.md","role":"supporting_file","sha256":"bdbc988ae7e958abf030be9632d79ac53a8dc1cd3fc1a37aaf53ed2da051c4e4","source_name":"ai-shell.md"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"schema":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","schema_version":1,"schemas":{"asset_verification":"https://tokrepo.com/schemas/asset-verification.schema.json","evidence_bundle":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","install_plan":"https://tokrepo.com/schemas/install-plan.schema.json","provenance":"https://tokrepo.com/schemas/provenance.schema.json","sbom":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json#/properties/sbom"},"signature_evidence":{"content_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","hash_algorithm":"sha256","install_plan_hash":"786afce7201b734dc293d8b6c36e84999bf70939ba41c855d46bc43fed38fad6","schema_version":1,"signed_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","target":"codex"},"sbom":{"asset_kind":"script","asset_title":"AI Shell — Natural Language to Shell Commands","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","capability_flags":{"destructive":false,"executes_code":true,"modifies_global_config":false,"network_access":false,"requires_secrets":[]},"content_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":1477,"path":"~/.codex/tokrepo/staged/da61dedb-cb50-41f6-bb0c-72013a520bd6/ai-shell.md","role":"supporting_file","sha256":"bdbc988ae7e958abf030be9632d79ac53a8dc1cd3fc1a37aaf53ed2da051c4e4","source_name":"ai-shell.md"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"signature_evidence":{"content_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","hash_algorithm":"sha256","install_plan_hash":"786afce7201b734dc293d8b6c36e84999bf70939ba41c855d46bc43fed38fad6","schema_version":1,"signed_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"provenance_v2":{"asset_kind":"script","asset_title":"AI Shell — Natural Language to Shell Commands","asset_uuid":"da61dedb-cb50-41f6-bb0c-72013a520bd6","computed_bundle_hash":"432af18aa5f1794ded971356317117bc3ae4c6b2ab897a478957dd2f4acb6eae","content_hash":"44ae5082c695a7ed80b9c532a23dba391c9347051510db70354ce19a94418311","created_at":"2026-04-01 12:14:16","generated_at":"2026-07-02T17:33:06Z","install_plan_hash":"786afce7201b734dc293d8b6c36e84999bf70939ba41c855d46bc43fed38fad6","owner_name":"Script Depot","owner_uuid":"8a910e34-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/ai-shell-natural-language-shell-commands-da61dedb","updated_at":"2026-07-03 01:33:04","visibility":1},"transitive_dependencies":null}}