write_file_encodingTier 1 · 70% confidence

ai-agents-write-file-encoding-writefile-tool-writes-corrupted-characters-to-outp-6c12ac09

agent: ai_agents

When does this happen?

IF WriteFile tool writes corrupted characters (�) to output file when saving content containing non-ASCII text (e.g., Traditional Chinese translations).

How others solved it

THEN Ensure the WriteFile tool explicitly sets UTF-8 encoding when writing files. In Gemini CLI, this can be worked around by verifying the input content is properly UTF-8 encoded before passing to WriteFile, or by using an alternative tool that respects encoding. Consider filing a bug to the developers to fix the underlying issue.

// Example: when writing translated text, ensure the string is UTF-8 encoded
const text = fs.readFileSync('translation_output.txt', 'utf-8');
await writeFile('index.md', text);

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics