Skip to content
Aisman Docs

Settings and maintenance

The Settings area in the dashboard provides configuration and maintenance tools for your Aisman project.

AI tool instructions

Section titled “AI tool instructions”

The AI tool instructions tab lets you view and edit the instruction file for your coding agent (for example .github/copilot-instructions.md).

  • The file browser uses your browser’s File System Access API to browse your local project files — it never reads files from the server.
  • If your browser does not support the File System Access API, Aisman shows an error message instead of falling back to server-side browsing.
  • When the instruction file is missing a reference to .aisman/instructions.md, Aisman shows a warning with an Add reference button that updates and saves the file immediately without opening a system save dialog.
  • The instruction file path is always included in generated workflow input when the Include instructions option is checked in Workflow Step 2.

Fixes tab

Section titled “Fixes tab”

The Fixes tab provides project-scoped maintenance actions that you can run to correct data issues.

Fix note newlines

Section titled “Fix note newlines”

This action corrects escaped newline sequences (\n) in issue note text for the current project. It replaces literal backslash-n sequences with actual newline characters.

  1. Open Settings and switch to the Fixes tab.
  2. Click Execute fix next to “Fix note newlines”.
  3. Aisman runs the correction on all notes belonging to issues in the currently selected project and reports how many rows were updated.

In-browser file picker

Section titled “In-browser file picker”

Aisman includes a custom in-browser file and folder picker that replaces the native system dialog:

  • For normal users: The picker uses the browser’s File System Access API to browse your local project files within the authorized project root. You cannot navigate above the project root.
  • For master users: A server-side file browser is available for browsing server files when specifically needed (for example, locating server-side template files).
  • The picker supports both file selection mode and directory-only selection mode.
  • Double-clicking a file immediately confirms the selection.
  • The path bar shows the current relative path and allows manual entry.