BranchesTags

Repository files navigation

freeagent

freeagent is an unofficial command-line client for the FreeAgent API. It is designed for people, shell scripts, and software agents. It provides explicit account profiles, machine-readable discovery, stable JSON output, and guarded financial writes.

This project is independent of FreeAgent. It is not endorsed, sponsored, or supported by FreeAgent.

Caution

FreeAgent records can affect accounts, banking, payroll, and tax. Start with a sandbox profile. Review every production mutation. The CLI cannot make an accounting or tax decision for an operator.

Status

Version 0.1.0 is the first public preview. Machine envelopes, error classes, and exit semantics use stable protocol version 1. The CLI release version remains pre-1.0 while its documented command catalog can expand.

What it provides

  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.

Install

Download an archive and checksums.txt from GitHub Releases, then put freeagent on PATH.

Go 1.26.7 or later can also install the current source release:

go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest

Verify the installation:

freeagent version --output json

See release and installation guidance for checksum, SBOM, and source-build instructions.

Quick start

  1. Create and finish setting up a FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client secret through the hidden prompt, or use --stdin with a protected password- manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25

Never put the client secret, access token, refresh token, or redirected OAuth URL in a command-line argument, a repository, a prompt, or a log.

Read the full quick start and OAuth application setup before using production.

Agent use

Agent calls must select a profile and disable interaction:

freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100

--agent defaults to JSON, disables prompts, and keeps stdout for protocol data. The CLI does not use terminal colour or a pager in any mode. Diagnostics and structured errors go to stderr. Use JSONL for long result streams. An explicit --output raw preserves untrusted upstream bytes and must not write to a terminal.

Before any write, discover the operation schema, build exact input, and run the operation's dry-run form. Every write requires the short-lived confirmation bound to that exact request. This is an anti-accident binding, not proof of human approval. If the CLI returns exit code 8, the outcome is unknown: read the target state and reconcile it before considering another write.

The repository skill supplies the complete agent workflow: .agents/skills/freeagent-cli/SKILL.md. See agent use and examples.

Documentation

Contributing and security

Read CONTRIBUTING.md before opening a change. Report a security problem privately as described in SECURITY.md. Do not put credentials, private financial records, or a vulnerability exploit in a public issue.

Licence

MIT. See LICENSE.

About

Unofficial agent-safe CLI for the FreeAgent API

Topics

accountingagent-skillsclifreeagentgo

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
freeagent
freeagent is an unofficial command-line client for the
FreeAgent API. It is designed for people, shell
scripts, and software agents. It provides explicit account profiles,
machine-readable discovery, stable JSON output, and guarded financial writes.
This project is independent of FreeAgent. It is not endorsed, sponsored, or
supported by FreeAgent.
Caution
FreeAgent records can affect accounts, banking, payroll, and tax. Start with a
sandbox profile. Review every production mutation. The CLI cannot make an
accounting or tax decision for an operator.
Status
Version 0.1.0 is the first public preview. Machine envelopes, error classes,
and exit semantics use stable protocol version 1. The CLI release version
remains pre-1.0 while its documented command catalog can expand.
What it provides
  • Separate sandbox and production profiles.
  • Bring-your-own FreeAgent OAuth application credentials.
  • OAuth secrets and rotating refresh tokens in the operating-system keyring.
  • Human and agent output modes with separate stdout and stderr contracts.
  • Runtime operation discovery through capabilities and schema.
  • Bounded pagination for agent and batch use.
  • Read-only policy controls and guarded production mutations.
  • A relative-path raw API command for API features that do not yet have a
catalogued resource command.
  • A repository Agent Skill in .agents/skills/freeagent-cli.
Install
Download an archive and checksums.txt from
GitHub Releases, then
put freeagent on PATH.
Go 1.26.7 or later can also install the current source release:
go install github.com/timbrinded/freeagent-cli/cmd/freeagent@latest
Verify the installation:
freeagent version --output json
See release and installation guidance for checksum, SBOM,
and source-build instructions.
Quick start
  1. Create and finish setting up a
FreeAgent sandbox company.
  2. Register a FreeAgent OAuth application. Choose an exact IP-loopback redirect
URI, such as http://127.0.0.1:8484/oauth/callback.
  3. Add a named sandbox profile. Supply the environment, client ID, the same
registered redirect URI, and a fixed API date.
  4. Run freeagent auth set-client-secret --profile sandbox. Enter the client
secret through the hidden prompt, or use --stdin with a protected password-
manager pipe.
  5. Run freeagent auth login --profile sandbox. Complete the approval in a
browser.
  6. Confirm the context before reading data:
freeagent profile show --profile sandbox --output json
freeagent auth status --profile sandbox --agent
freeagent capabilities --profile sandbox --agent
freeagent invoices list --profile sandbox --output json --no-input --per-page 25
Never put the client secret, access token, refresh token, or redirected OAuth
URL in a command-line argument, a repository, a prompt, or a log.
Read the full quick start and
OAuth application setup before using production.
Agent use
Agent calls must select a profile and disable interaction:
freeagent capabilities --profile sandbox --agent
freeagent schema invoices.list --profile sandbox --agent
freeagent invoices list \
--profile sandbox \
--agent \
--all \
--max-items 100
--agent defaults to JSON, disables prompts, and keeps stdout for protocol
data. The CLI does not use terminal colour or a pager in any mode. Diagnostics
and structured errors go to stderr. Use JSONL for long result streams. An
explicit --output raw preserves untrusted upstream bytes and must not write
to a terminal.
Before any write, discover the operation schema, build exact input, and run the
operation's dry-run form. Every write requires the short-lived confirmation
bound to that exact request. This is an anti-accident binding, not proof of
human approval. If the CLI returns exit code 8, the outcome is unknown: read
the target state and reconcile it before considering another write.
The repository skill supplies the complete agent workflow:
.agents/skills/freeagent-cli/SKILL.md.
See agent use and examples.
Documentation
Contributing and security
Read CONTRIBUTING.md before opening a change. Report a
security problem privately as described in SECURITY.md. Do not
put credentials, private financial records, or a vulnerability exploit in a
public issue.
Licence
MIT. See LICENSE.
About
Unofficial agent-safe CLI for the FreeAgent API
Topics
accountingagent-skillsclifreeagentgo
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages