Configuration and extensions
settings.json, LINE.md, MCP servers, hooks, skills and plugins.
- Can a project have its own Line CLI settings?Yes. A project's .line/settings.json can add ask and deny permission rules, a verify_command and hooks. It can never allow more.How-to
- Does Line CLI read AGENTS.md or CLAUDE.md files?Line follows LINE.md or AGENTS.md in the project. /status also detects CLAUDE.md as an instructions file in the folder.FAQ
- How do I add an MCP server to Line CLI?Add the server to ~/.line/mcp.json (yours) or .mcp.json in the project under mcpServers, with a command or a URL. Then /mcp reload.How-to
- How do I create my own Line CLI plugin?Run line plugin new <name> to scaffold an enabled plugin, edit plugin.json to add tools, commands, hooks or skills, then re-enable after changes.How-to
- How do I give Line CLI instructions for every project?Write them in ~/.line/LINE.md. Line follows it in every session, together with the project's own LINE.md or AGENTS.md.How-to
- How do I install and enable a Line CLI plugin?Install with line plugin install <folder|owner/repo>, review with line plugin info, then enable. Plugins stay off until you enable them.How-to
- How do I keep Line CLI's settings in a different folder?Set LINE_CONFIG_DIR to a folder path. Line then stores sign-in, settings, sessions and logs there instead of ~/.config/line.How-to
- How do I let Line CLI read a folder outside my project?Add the folder with --add-dir for one run, or additional_dirs in settings.json to allow it always, without approval prompts.How-to
- How do I make Line CLI show diffs side by side?Type /diff split for one view, or set "diff_view": "split" in settings.json to make side-by-side the default.How-to
- How do I use hooks in Line CLI?Hooks run your scripts on PreToolUse, PostToolUse, UserPromptSubmit, Stop and SessionStart. Exit code 2 from a hook blocks the action.How-to
- How do I use skills in Line CLI?Skills are folders with a SKILL.md that teach Line a procedure. Install with line skill install, list with line skill list, or let the agent propose one.How-to
- How do I write a LINE.md for my project?LINE.md is a Markdown file of project instructions Line follows every session. Run /init to draft one, then edit it and commit it.How-to
- My MCP server shows "failed" in Line CLIA failed MCP server couldn't start or connect. Check its command or URL, environment variables and tokens, then run /mcp reload.Troubleshooting
- My MCP server shows "not trusted". How do I fix it?Servers defined in a project's .mcp.json don't start until you trust them. Run /mcp trust <name> or line mcp trust <name>.Troubleshooting
- What can I put in Line CLI's settings.json?Line's settings file ~/.config/line/settings.json holds model, effort, auto-approve, thinking, mouse, RTL, diff, repo map, verify, sandbox and permissions.Reference
- What's the difference between hooks, plugins, skills and MCP in Line CLI?Hooks run your scripts at events, plugins bundle tools/commands/hooks/skills, skills are instructions, and MCP connects external tool servers.Explainer
- Where does Line CLI search for skills, and are there limits?Skill search defaults to the anthropics/skills GitHub repo; add sources with skill_sources or LINE_SKILL_SOURCES. Each skill: 60 files, 2 MB max.FAQ
- Which environment variables does Line CLI use?Environment variables for the Line installer (LINE_VERSION, LINE_INSTALL_DIR, LINE_NO_MODIFY_PATH) and for Line itself (LINE_CONFIG_DIR and more).Reference
- Why did my Line CLI plugin turn itself off?Line disables a plugin when any of its files change after you enabled it. Review the change and enable it again.Troubleshooting
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.