Environment Variables

Environment variables for overriding configuration.

Environment variables override both the global config file and per-project config. Useful for CI/CD or when you do not want to store credentials on disk.

Available variables

FlagDescription
DEVTO_API_KEYOverrides the API key from config.json and .devto.json
DEVTO_READ_ONLYWhen set to "true", blocks all write tools. The 17 read-only tools (get_*, list_*, search_*) still work.

Examples

bash
# Use a specific API key for this session
export DEVTO_API_KEY=devto_xxxxxxxxxxxx
# Enable read-only mode (no writes to project tracker)
export DEVTO_READ_ONLY=true

Read-only mode

When DEVTO_READ_ONLY=true, the following tools are blocked:

  • -create_plan, confirm_plan
  • -create_epic, create_task, create_subtask
  • -update_task, update_epic, delete_issue
  • -add_comment, delete_comment
  • -create_sprint, move_to_sprint, manage_sprint
  • -link_issues, log_work, set_estimate
  • -create_version, release_version
  • -move_to_backlog, bulk_create_tasks, bulk_update_tasks
  • -attach_file, manage_watchers (add/remove only)

Read tools like get_project_summary, get_tasks, list_sprints, search_issues, and all field discovery tools continue to work normally.