The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
Clarify docs: skills go to the effective CODEX_HOME, not ~/.codex
Devin Foley80766e589ca1
diff --git a/packages/adapters/codex-local/src/index.ts b/packages/adapters/codex-local/src/index.tsindex 0115be0685..10cf6fe974 100644--- a/packages/adapters/codex-local/src/index.ts+++ b/packages/adapters/codex-local/src/index.ts@@ -42,7 +42,7 @@ Notes:- Prompts are piped via stdin (Codex receives "-" prompt argument).- If instructionsFilePath is configured, Paperclip prepends that file's contents to the stdin prompt on every run.- Codex exec automatically applies repo-scoped AGENTS.md instructions from the active workspace. Paperclip cannot suppress that discovery in exec mode, so repo AGENTS.md files may still apply even when you only configured an explicit instructionsFilePath.-- Paperclip injects desired local skills into $CODEX_HOME/skills/ (defaulting to ~/.codex/skills/) at execution time so Codex can discover "$paperclip" and related skills without polluting the project working directory.+- Paperclip injects desired local skills into the effective CODEX_HOME/skills/ directory at execution time so Codex can discover "$paperclip" and related skills without polluting the project working directory. In managed-home mode (the default) this is ~/.paperclip/instances/<id>/companies/<companyId>/codex-home/skills/; when CODEX_HOME is explicitly overridden in adapter config, that override is used instead.- Unless explicitly overridden in adapter config, Paperclip runs Codex with a per-company managed CODEX_HOME under the active Paperclip instance and seeds auth/config from the shared Codex home (the CODEX_HOME env var, when set, or ~/.codex).- Some model/tool combinations reject certain effort levels (for example minimal with web search enabled).- When Paperclip realizes a workspace/runtime for a run, it injects PAPERCLIP_WORKSPACE_* and PAPERCLIP_RUNTIME_* env vars for agent-side tooling.diff --git a/packages/adapters/codex-local/src/server/execute.ts b/packages/adapters/codex-local/src/server/execute.tsindex be4606c88a..35c681ee8d 100644--- a/packages/adapters/codex-local/src/server/execute.ts+++ b/packages/adapters/codex-local/src/server/execute.ts@@ -273,6 +273,8 @@ export async function execute(ctx: AdapterExecutionContext): Promise<AdapterExecconst defaultCodexHome = resolveManagedCodexHomeDir(process.env, agent.companyId);const effectiveCodexHome = configuredCodexHome ?? preparedManagedCodexHome ?? defaultCodexHome;await fs.mkdir(effectiveCodexHome, { recursive: true });+ // Inject skills into the same CODEX_HOME that Codex will actually run with+ // (managed home in the default case, or an explicit override from adapter config).const codexSkillsDir = resolveCodexSkillsDir(effectiveCodexHome);await ensureCodexSkillsInjected(onLog,diff --git a/packages/adapters/codex-local/src/server/skills.ts b/packages/adapters/codex-local/src/server/skills.tsindex bf936691aa..0916c0b74b 100644--- a/packages/adapters/codex-local/src/server/skills.ts+++ b/packages/adapters/codex-local/src/server/skills.ts@@ -31,7 +31,7 @@ async function buildCodexSkillSnapshot(sourcePath: entry.source,targetPath: null,detail: desiredSet.has(entry.key)- ? "Will be linked into $CODEX_HOME/skills/ on the next run."+ ? "Will be linked into the effective CODEX_HOME/skills/ directory on the next run.": null,required: Boolean(entry.required),requiredReason: entry.requiredReason ?? null,diff --git a/server/src/__tests__/codex-local-skill-sync.test.ts b/server/src/__tests__/codex-local-skill-sync.test.tsindex 55568befe3..0205f22d77 100644--- a/server/src/__tests__/codex-local-skill-sync.test.ts+++ b/server/src/__tests__/codex-local-skill-sync.test.ts@@ -43,7 +43,7 @@ describe("codex local skill sync", () => {expect(before.desiredSkills).toContain(paperclipKey);expect(before.entries.find((entry) => entry.key === paperclipKey)?.required).toBe(true);expect(before.entries.find((entry) => entry.key === paperclipKey)?.state).toBe("configured");- expect(before.entries.find((entry) => entry.key === paperclipKey)?.detail).toContain("$CODEX_HOME/skills/");+ expect(before.entries.find((entry) => entry.key === paperclipKey)?.detail).toContain("CODEX_HOME/skills/");});it("does not persist Paperclip skills into CODEX_HOME during sync", async () => {