Tree [07696a] master /

File Date Author Commit
old 2011-07-28 Vilson Vieira Vilson Vieira [45b1ca] renaming files appropriatelly
omniscientAA 2012-04-11 rfabbri rfabbri [66ae0b] terminada versao zero do AA omnisciente
.gitignore 2011-07-28 M. Quasar M. Quasar [9e5ce0] Merge pull request #3 from mquasar/master
COPYING 2011-09-11 Andres MRM Andres MRM [a2f91b] Merge branch 'master' of ssh://labmacambira.git...
FAQ 2013-01-02 Ricardo Fabbri Ricardo Fabbri [d1ee6d] FAQ added, with item on espeak slowness
README 2013-01-01 Ricardo Fabbri Ricardo Fabbri [3b68d2] last url nigthsc -> pp
README_AAPP 2011-08-25 Alexandre Negrão Alexandre Negrão [dcdb37] corrected package name
README_OMNISCIENT 2012-06-28 rfabbri rfabbri [833a14] pequena adicao sobre o AA Omniciente
TODO 2012-04-20 rfabbri rfabbri [a37560] adicionado item no TODO
aa-what-is-aa 2012-04-06 Ricardo Fabbri Ricardo Fabbri [a104fb] description from an IRC chat of what is aa? 2013-01-02 Ricardo Fabbri Ricardo Fabbri [07696a] daemon now outputs to /tmp/aa.stdout and /tmp/a... 2011-09-13 Andres MRM Andres MRM [771b67] tirando texto de debug
dump20120628.sql.tar.gz 2012-06-28 rfabbri rfabbri [342aa9] adicionado dum do bd de hj 2011-09-11 Andres MRM Andres MRM [a2f91b] Merge branch 'master' of ssh://labmacambira.git... 2011-08-23 Andres MRM Andres MRM [16e89a] resurrect e atalho

Read Me

oooOoOo[ AA ]oOoOooo

What is AA? Read the file aa-what-is-aa for one way to look at it.


Put on your /usr/local/bin:

    $ sudo cp /usr/local/bin/aa

Or just create a link:

    $ sudo ln -s /complete/path/to/your/ /usr/local/bin/aa

Configure your nickname:

    $ aa config user.nickname <YOUR NICKNAME HERE>

And the AA-Web (the web server) URL:

    $ aa config server.url

Install dependencies:

    $ sudo apt-get install libnotify-bin espeak


Now you can use:

    $ aa start                        ... starts your session
    $ aa post foo                     ... posts foo
    $ aa shout foo                    ... posts foo and sends message to server
    $ aa stop                         ... stops your session
    $ aa config <attribute> <value>   ... sets some attribute
    $ aa status|st                    ... checks if daemon is running
    $ aa time|ts                      ... show time and timeslot info
    $ aa viewlog                      ... shows your current log
    $ aa push                         ... pushes your log to the server

For now, just 'aa stop' will send your 'work log' to the server. You
can see your log at (or any server configured using
aa config server.url <URL SERVER HERE>).

We suggest to shortcut aa shout to a simpler name such as 'as', since it is used
very often:

  echo 'alias as="aa shout"'  >> ~/.bashrc


Configuration attributes currently in use:


Suggested Workflow

A suggestion for your daily workflow on Lab Macambira:

* Look at the tickets of your GT on
    aa tickets
    aa showticket <ticket number>
* Use AA
    aa start
    aa shout working on foo
    aa stop
    aa push
* Use '''shout''' instead of '''post''' when you are connected to the Web
* Open how many tickets your consider necessary to organize your actions
* Keep atention to your GT milestones
* Close the tickets you'll fixing
* Use the wiki a lot to report your activities:
* Use the mail list ( and IRC (#labmacambira at


If you don't have permission as developer on the AA's SourceForge project,
please send an email asking to

If you have permission, clone the repos:

    git clone ssh://

Change USERNAME by your SourceForge username.

For more information, take a look at